1.\" $NetBSD: elf2ecoff.1,v 1.10 2012/03/05 10:57:19 njoly 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.\" .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.Sh HISTORY 44.Nm 45was originally developed for 46.Nx Ns Tn /pmax 47by Ted Lemon 48and was first distributed with the pmax port of 49.Nx 1.1 . 50.Sh BUGS 51.Nm 52assumes there are no multiply-referenced symbols in the input ELF symbol 53section. 54It may be necessary to link with 55.Fl x 56to avoid duplicate symbols. 57.Pp 58In some environments, the GNU binutils 59.Xr objcopy 1 60utility may be a better solution than 61.Nm . 62