| OLD | NEW |
| 1 '\" t |
| 1 .\" Title: yasm_objfmts | 2 .\" Title: yasm_objfmts |
| 2 .\" Author: Peter Johnson <peter@tortall.net> | 3 .\" Author: Peter Johnson <peter@tortall.net> |
| 3 .\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/> | 4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
| 4 .\" Date: February 2007 | 5 .\" Date: February 2007 |
| 5 .\" Manual: Yasm Supported Object Formats | 6 .\" Manual: Yasm Supported Object Formats |
| 6 .\" Source: Yasm | 7 .\" Source: Yasm |
| 8 .\" Language: English |
| 7 .\" | 9 .\" |
| 8 .TH "YASM_OBJFMTS" "7" "February 2007" "Yasm" "Yasm Supported Object Formats" | 10 .TH "YASM_OBJFMTS" "7" "February 2007" "Yasm" "Yasm Supported Object Formats" |
| 11 .\" ----------------------------------------------------------------- |
| 12 .\" * set default formatting |
| 13 .\" ----------------------------------------------------------------- |
| 9 .\" disable hyphenation | 14 .\" disable hyphenation |
| 10 .nh | 15 .nh |
| 11 .\" disable justification (adjust text to left margin only) | 16 .\" disable justification (adjust text to left margin only) |
| 12 .ad l | 17 .ad l |
| 18 .\" ----------------------------------------------------------------- |
| 19 .\" * MAIN CONTENT STARTS HERE * |
| 20 .\" ----------------------------------------------------------------- |
| 13 .SH "NAME" | 21 .SH "NAME" |
| 14 yasm_objfmts \- Yasm Supported Object Formats | 22 yasm_objfmts \- Yasm Supported Object Formats |
| 15 .SH "SYNOPSIS" | 23 .SH "SYNOPSIS" |
| 16 .HP 5 | 24 .HP \w'\fByasm\fR\ 'u |
| 17 \fByasm\fR \fB\-f\ \fR\fB\fIobjfmt\fR\fR \fB\fI...\fR\fR | 25 \fByasm\fR \fB\-f\ \fR\fB\fIobjfmt\fR\fR \fB\fI\&.\&.\&.\fR\fR |
| 18 .SH "DESCRIPTION" | 26 .SH "DESCRIPTION" |
| 19 .PP | 27 .PP |
| 20 The standard Yasm distribution includes a number of modules for different object
formats (Yasm's primary output). | 28 The standard Yasm distribution includes a number of modules for different object
formats (Yasm\'s primary output)\&. |
| 21 .PP | 29 .PP |
| 22 The object format is selected on the | 30 The object format is selected on the |
| 23 \fByasm\fR(1) | 31 \fByasm\fR(1) |
| 24 command line by use of the | 32 command line by use of the |
| 25 \fB\-f \fR\fB\fIobjfmt\fR\fR | 33 \fB\-f \fR\fB\fIobjfmt\fR\fR |
| 26 command line option. | 34 command line option\&. |
| 27 .SH "BIN" | 35 .SH "BIN" |
| 28 .PP | 36 .PP |
| 29 The | 37 The |
| 30 \(lqbin\(rq | 38 \(lqbin\(rq |
| 31 object format produces a flat\-format, non\-relocatable binary file. It is appro
priate for producing DOS .COM executables or things like boot blocks. It support
s only 3 sections and those sections are written in a predefined order to the ou
tput file. | 39 object format produces a flat\-format, non\-relocatable binary file\&. It is app
ropriate for producing DOS \&.COM executables or things like boot blocks\&. It s
upports only 3 sections and those sections are written in a predefined order to
the output file\&. |
| 32 .SH "COFF" | 40 .SH "COFF" |
| 33 .PP | 41 .PP |
| 34 The COFF object format is an older relocatable object format used on older Unix
and compatible systems, and also (more recently) on the DJGPP development system
for DOS. | 42 The COFF object format is an older relocatable object format used on older Unix
and compatible systems, and also (more recently) on the DJGPP development system
for DOS\&. |
| 35 .SH "DBG" | 43 .SH "DBG" |
| 36 .PP | 44 .PP |
| 37 The | 45 The |
| 38 \(lqdbg\(rq | 46 \(lqdbg\(rq |
| 39 object format is not a | 47 object format is not a |
| 40 \(lqreal\(rq | 48 \(lqreal\(rq |
| 41 object format; the output file it creates simply describes the sequence of calls
made to it by Yasm and the final object and symbol table information in a human
\-readable text format (that in a normal object format would get processed into
that object format's particular binary representation). This object format is no
t intended for real use, but rather for debugging Yasm's internals. | 49 object format; the output file it creates simply describes the sequence of calls
made to it by Yasm and the final object and symbol table information in a human
\-readable text format (that in a normal object format would get processed into
that object format\'s particular binary representation)\&. This object format is
not intended for real use, but rather for debugging Yasm\'s internals\&. |
| 42 .SH "ELF" | 50 .SH "ELF" |
| 43 .PP | 51 .PP |
| 44 The ELF object format really comes in two flavors: | 52 The ELF object format really comes in two flavors: |
| 45 \(lqelf32\(rq | 53 \(lqelf32\(rq |
| 46 (for 32\-bit targets) and | 54 (for 32\-bit targets) and |
| 47 \(lqelf64\(rq | 55 \(lqelf64\(rq |
| 48 (for 64\-bit targets). ELF is a standard object format in common use on modern U
nix and compatible systems (e.g. Linux, FreeBSD). ELF has complex support for re
locatable and shared objects. | 56 (for 64\-bit targets)\&. ELF is a standard object format in common use on modern
Unix and compatible systems (e\&.g\&. Linux, FreeBSD)\&. ELF has complex suppor
t for relocatable and shared objects\&. |
| 49 .SH "MACHO" | 57 .SH "MACHO" |
| 50 .PP | 58 .PP |
| 51 The Mach\-O object format really comes in two flavors: | 59 The Mach\-O object format really comes in two flavors: |
| 52 \(lqmacho32\(rq | 60 \(lqmacho32\(rq |
| 53 (for 32\-bit targets) and | 61 (for 32\-bit targets) and |
| 54 \(lqmacho64\(rq | 62 \(lqmacho64\(rq |
| 55 (for 64\-bit targets). Mach\-O is used as the object format on MacOS X. As Yasm
currently only supports x86 and AMD64 instruction sets, it can only generate Mac
h\-O objects for Intel\-based Macs. | 63 (for 64\-bit targets)\&. Mach\-O is used as the object format on MacOS X\&. As Y
asm currently only supports x86 and AMD64 instruction sets, it can only generate
Mach\-O objects for Intel\-based Macs\&. |
| 56 .SH "RDF" | 64 .SH "RDF" |
| 57 .PP | 65 .PP |
| 58 The RDOFF2 object format is a simple multi\-section format originally designed f
or NASM. It supports segment references but not WRT references. It was designed
primarily for simplicity and has minimalistic headers for ease of loading and li
nking. A complete toolchain (linker, librarian, and loader) is distributed with
NASM. | 66 The RDOFF2 object format is a simple multi\-section format originally designed f
or NASM\&. It supports segment references but not WRT references\&. It was desig
ned primarily for simplicity and has minimalistic headers for ease of loading an
d linking\&. A complete toolchain (linker, librarian, and loader) is distributed
with NASM\&. |
| 59 .SH "WIN32" | 67 .SH "WIN32" |
| 60 .PP | 68 .PP |
| 61 The Win32 object format produces object files compatible with Microsoft compiler
s (such as Visual C++) that target the 32\-bit x86 Windows platform. The object
format itself is an extended version of COFF. | 69 The Win32 object format produces object files compatible with Microsoft compiler
s (such as Visual C++) that target the 32\-bit x86 Windows platform\&. The objec
t format itself is an extended version of COFF\&. |
| 62 .SH "WIN64" | 70 .SH "WIN64" |
| 63 .PP | 71 .PP |
| 64 The Win64 object format produces object files compatible with Microsoft compiler
s that target the 64\-bit | 72 The Win64 object format produces object files compatible with Microsoft compiler
s that target the 64\-bit |
| 65 \(lqx64\(rq | 73 \(lqx64\(rq |
| 66 Windows platform. This format is very similar to the win32 object format, but pr
oduces 64\-bit objects. | 74 Windows platform\&. This format is very similar to the win32 object format, but
produces 64\-bit objects\&. |
| 67 .SH "XDF" | 75 .SH "XDF" |
| 68 .PP | 76 .PP |
| 69 The XDF object format is essentially a simplified version of COFF. It's a multi\
-section relocatable format that supports 64\-bit physical and virtual addresses
. | 77 The XDF object format is essentially a simplified version of COFF\&. It\'s a mul
ti\-section relocatable format that supports 64\-bit physical and virtual addres
ses\&. |
| 70 .SH "SEE ALSO" | 78 .SH "SEE ALSO" |
| 71 .PP | 79 .PP |
| 72 \fByasm\fR(1), | 80 \fByasm\fR(1), |
| 73 \fByasm_arch\fR(7) | 81 \fByasm_arch\fR(7) |
| 74 .SH "AUTHOR" | 82 .SH "AUTHOR" |
| 75 .PP | 83 .PP |
| 76 \fBPeter\fR \fBJohnson\fR <peter@tortall.net> | 84 \fBPeter Johnson\fR <\&peter@tortall\&.net\&> |
| 77 .sp -1n | 85 .RS 4 |
| 78 .IP "" 3n | |
| 79 Author. | 86 Author. |
| 87 .RE |
| 80 .SH "COPYRIGHT" | 88 .SH "COPYRIGHT" |
| 89 .br |
| 81 Copyright \(co 2006 Peter Johnson | 90 Copyright \(co 2006 Peter Johnson |
| 91 .br |
| OLD | NEW |