usr.bin/elf2ecoff/elf2ecoff.1

   1 .\"     $NetBSD: elf2ecoff.1,v 1.8 2002/09/30 11:08:59 grant Exp $
   2 .\"
   3 .\" Copyright 1996 The Board of Trustees of The Leland Stanford
   4 .\" Junior University. All Rights Reserved.
   5 .\"
   6 .\" Author: Jonathan Stone
   7 .\"
   8 .\" Permission to use, copy, modify, and distribute this
   9 .\" software and its documentation for any purpose and without
  10 .\" fee is hereby granted, provided that the above copyright
  11 .\" notice and the above authorship notice appear in all copies.
  12 .\" Stanford University makes no representations about the suitability
  13 .\" of this software for any purpose.  It is provided "as is" without
  14 .\" express or implied warranty.
  15 .Dd September 30, 1996
  16 .Dt ELF2ECOFF 1
  17 .Os
  18 .Sh NAME
  19 .Nm elf2ecoff
  20 .Nd convert a NetBSD ELF-format executable to NetBSD ECOFF format
  21 .Sh SYNOPSIS
  22 .Nm elf2ecoff
  23 .Ar elf-file
  24 .Ar ecoff-file
  25 .Sh DESCRIPTION
  26 Reads a fully-linked ELF executable (such as a  linked kernel)
  27 and produces an equivalent ECOFF format executable file.
  28 .Pp
  29 The
  30 .Nm
  31 utility is used to convert native
  32 .Nx
  33 ELF binaries
  34 to ECOFF format, for compatibility with DECstation diskless-boot
  35 PROM code and diskless-boot servers that require ECOFF format binaries.
  36 .\" .Sh DIAGNOSTICS
  37 .Sh SEE ALSO
  38 .Xr elf2aout 1 ,
  39 .Xr ld 1 ,
  40 .Xr kvm 3 ,
  41 .Xr a.out 5 ,
  42 .Xr elf 5 ,
  43 .Xr kvm_mkdb 8
  44 .Sh HISTORY
  45 .Nm
  46 was originally developed for
  47 .Nx Ns Tn /pmax
  48 by Ted Lemon
  49 and was first distributed with the pmax port of
  50 .Nx 1.1 .
  51 .Sh BUGS
  52 .Nm
  53 assumes there are no multiply-referenced symbols in the input ELF symbol
  54 section.
  55 It may be necessary to link with
  56 .Fl x
  57 to avoid duplicate symbols.
  58 .Pp
  59 In some environments, the GNU binutils
  60 .Xr objcopy 1
  61 utility may be a better solution than
  62 .Nm .