77 lines
1.8 KiB
Groff
77 lines
1.8 KiB
Groff
.\" $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 .
|