1.\" $NetBSD: elf2ecoff.1,v 1.6 2000/08/24 01:20:35 jhawk 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 26Reads a fully-linked ELF executable (such as a linked kernel) 27and produces an equivalent ECOFF format executable file. 28.Pp 29The 30.Nm 31utility is used to convert native 32.Nx 33ELF binaries 34to ECOFF format, for compatibility with DECstation diskless-boot 35PROM code and diskless-boot servers that require ECOFF format binaries. 36.Pp 37.\" .Sh DIAGNOSTICS 38.Pp 39.Sh SEE ALSO 40.Xr elf2aout 1 , 41.Xr ld 1 , 42.Xr a.out 5 , 43.Xr elf 5 , 44.Xr kvm 3 , 45.Xr kvm_mkdb 8 . 46.Sh BUGS 47.Nm 48assumes there are no multiply-referenced symbols in the input ELF symbol 49section. It may be necessary to link with 50.Fl x 51to avoid duplicate symbols. 52.Pp 53In some environments, the GNU binutils 54.Xr objcopy 1 55utility may be a better solution than 56.Nm "" . 57.Sh HISTORY 58.Nm 59was originally developed for 60.Nx Ns Tn /pmax 61by Ted Lemon 62and was first distributed with the pmax port of 63.Nx 1.1 . 64