\" $NetBSD: elf2aout.1,v 1.11 2019/05/18 21:16:12 christos Exp $
\"
\" Copyright 1996 The Board of Trustees of The Leland Stanford
\" Junior University. All Rights Reserved.
\"
\" Author: Jonathan Stone
\"
\" Permission to use, copy, modify, and distribute this
\" software and its documentation for any purpose and without
\" fee is hereby granted, provided that the above copyright
\" notice and the above authorship notice appear in all copies.
\" Stanford University makes no representations about the suitability
\" of this software for any purpose. It is provided "as is" without
\" express or implied warranty.
Dd September 30, 1996
Dt ELF2AOUT 1
Os
Sh NAME
Nm elf2aout
Nd convert a NetBSD ELF-format executable to NetBSD a.out format
Sh SYNOPSIS
Nm
Op Fl \&Os
Ar elf-file
Ar aout-file
Sh DESCRIPTION
Reads a fully-linked ELF executable (such as a linked kernel)
and produces an equivalent a.out format executable file.
Pp
The
Nm
utility is used to convert native
Nx
ELF binaries
to a.out format, for compatibility with bootblocks and kernel-reading
utilities like
Xr kvm 3 ,
which currently expect an a.out format kernel.
Pp
The following options are available:
Bl -tag -width flag
It Fl O
Produce
Dv OMAGIC
instead of
Dv ZMAGIC
binaries which is the default.
It Fl s
Preserve the symbol table.
El
\" .Sh DIAGNOSTICS
Sh SEE ALSO
Xr elf2ecoff 1 ,
Xr ld 1 ,
Xr kvm 3 ,
Xr a.out 5 ,
Xr elf 5
Sh HISTORY
Nm
was originally developed for
Nx Ns Tn /pmax
by Ted Lemon
and was first distributed with the pmax port of
Nx 1.1 .
Sh BUGS
Nm
assumes there are no multiply-referenced symbols in the input ELF symbol
section.
It may be necessary to link with
Fl x
to avoid such duplicate symbols.
Pp
In some environments, the GNU binutils
Xr objcopy 1
utility may be a better solution than
Nm .
