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 |