d0p1/ack
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

Update aelflod.1 to describe options, mention symbol table.

Browse source
This commit is contained in:
George Koehler 2016-12-13 17:22:45 -05:00
parent 5cf2a68438
commit 7e39a821f4
1 changed files with 36 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
util/amisc/aelflod.1
View file

@ -3,7 +3,7 @@
aelflod \- ACK ELF loader aelflod \- ACK ELF loader
.SH SYNOPSIS .SH SYNOPSIS
.B aelflod .B aelflod
[-h] [-v] inputfile outputfile [-a\fInumber\fP] [-b] [-h] [-l] [-m\fInumber\fP] [-v] inputfile outputfile
.SH DESCRIPTION .SH DESCRIPTION
.I aelflod .I aelflod
converts an absolute ack.out file into a simple binary memory converts an absolute ack.out file into a simple binary memory
@ -11,6 +11,32 @@ dump wrapped up in an ELF executable.
It is suitable for producing executables for operating systems It is suitable for producing executables for operating systems
such as Linux. such as Linux.
.PP .PP
.I aelflod
accepts the following flags:
.TP
.BI \-a number
Set the ABI in the ELF header to \fInumber\fP.
The default value is \fI3\fP for Linux.
.TP
.B \-b
Write a big-endian ELF file.
.TP
.B \-h
Print a help message and exit.
.TP
.B \-l
Write a little-endian ELF file.
This is the default.
.TP
.BI \-m number
Set the machine type in the ELF header to \fInumber\fP.
The default value is \fI3\fP for Intel 386 (i386).
Other values are \fI4\fP for Motorola 68000 (m68k)
and \fI20\fP for PowerPC.
.TP
.B \-v
Be verbose.
.PP
The input file must contain exactly four segments: TEXT, ROM, The input file must contain exactly four segments: TEXT, ROM,
DATA and BSS, in that order, all occupying contiguous memory. DATA and BSS, in that order, all occupying contiguous memory.
The file must have all references resolved and be linked to a The file must have all references resolved and be linked to a
@ -18,10 +44,15 @@ fixed address.
The fixed address must be at least 0x54 bytes greater than a The fixed address must be at least 0x54 bytes greater than a
page boundary, in order to make room for the ELF header itself. page boundary, in order to make room for the ELF header itself.
.PP .PP
aelflod will write out an ELF header followed by each segment, in .I aelflod
order, ensuring that enough padding is inserted between each segment will write out an ELF header followed by each segment, in order,
ensuring that enough padding is inserted between each segment
to keep the offsets correct. to keep the offsets correct.
The created executable will contain just one rwx segment, and no The created executable will contain just one ELF segment mapped rwx.
sections. .PP
If the input file has symbols, then
.I aelflod
will convert the symbol table to ELF.
The output file has ELF section headers if and only if it has symbols.
.SH "SEE ALSO" .SH "SEE ALSO"
ack.out(5) ack.out(5)