xref: /netbsd-src/usr.bin/elf2ecoff/elf2ecoff.1 (revision 4d5ade5119970c77da01ef37cadbbaa2655c8a90)
1*4d5ade51Snjoly.\"	$NetBSD: elf2ecoff.1,v 1.10 2012/03/05 10:57:19 njoly Exp $
23fe138c1Sperry.\"
3fb8fff01Sjonathan.\" Copyright 1996 The Board of Trustees of The Leland Stanford
4fb8fff01Sjonathan.\" Junior University. All Rights Reserved.
5fb8fff01Sjonathan.\"
6fb8fff01Sjonathan.\" Author: Jonathan Stone
7fb8fff01Sjonathan.\"
8fb8fff01Sjonathan.\" Permission to use, copy, modify, and distribute this
9fb8fff01Sjonathan.\" software and its documentation for any purpose and without
10fb8fff01Sjonathan.\" fee is hereby granted, provided that the above copyright
11fb8fff01Sjonathan.\" notice and the above authorship notice appear in all copies.
12fb8fff01Sjonathan.\" Stanford University makes no representations about the suitability
13fb8fff01Sjonathan.\" of this software for any purpose.  It is provided "as is" without
14fb8fff01Sjonathan.\" express or implied warranty.
15fb8fff01Sjonathan.Dd September 30, 1996
16fb8fff01Sjonathan.Dt ELF2ECOFF 1
179e44e9b5Sgarbled.Os
18fb8fff01Sjonathan.Sh NAME
19fb8fff01Sjonathan.Nm elf2ecoff
20f6260667Sjhawk.Nd convert a NetBSD ELF-format executable to NetBSD ECOFF format
21fb8fff01Sjonathan.Sh SYNOPSIS
2238fdbc93Slukem.Nm elf2ecoff
2338fdbc93Slukem.Ar elf-file
2438fdbc93Slukem.Ar ecoff-file
25fb8fff01Sjonathan.Sh DESCRIPTION
26fb8fff01SjonathanReads a fully-linked ELF executable (such as a  linked kernel)
27fb8fff01Sjonathanand produces an equivalent ECOFF format executable file.
28fb8fff01Sjonathan.Pp
29fb8fff01SjonathanThe
3038fdbc93Slukem.Nm
3134a98169Sperryutility is used to convert native
3234a98169Sperry.Nx
3334a98169SperryELF binaries
34f6260667Sjhawkto ECOFF format, for compatibility with DECstation diskless-boot
35fb8fff01SjonathanPROM code and diskless-boot servers that require ECOFF format binaries.
36fb8fff01Sjonathan.\" .Sh DIAGNOSTICS
37fb8fff01Sjonathan.Sh SEE ALSO
38fb8fff01Sjonathan.Xr elf2aout 1 ,
39fb8fff01Sjonathan.Xr ld 1 ,
40f3dbbfddSwiz.Xr kvm 3 ,
41fb8fff01Sjonathan.Xr a.out 5 ,
42*4d5ade51Snjoly.Xr elf 5
43f3dbbfddSwiz.Sh HISTORY
44f3dbbfddSwiz.Nm
45f3dbbfddSwizwas originally developed for
46f3dbbfddSwiz.Nx Ns Tn /pmax
47f3dbbfddSwizby Ted Lemon
48f3dbbfddSwizand was first distributed with the pmax port of
49f3dbbfddSwiz.Nx 1.1 .
50fb8fff01Sjonathan.Sh BUGS
5138fdbc93Slukem.Nm
52fb8fff01Sjonathanassumes there are no multiply-referenced symbols in the input ELF symbol
53be8ae688Sgrantsection.
54be8ae688SgrantIt may be necessary to link with
5538fdbc93Slukem.Fl x
56fb8fff01Sjonathanto avoid duplicate symbols.
57fb8fff01Sjonathan.Pp
58fb8fff01SjonathanIn some environments, the GNU binutils
5938fdbc93Slukem.Xr objcopy 1
60fb8fff01Sjonathanutility may be a better solution than
61990562bfSwiz.Nm .
62