OLD | NEW |
| 1 '\" t |
1 .\" Title: yasm_dbgfmts | 2 .\" Title: yasm_dbgfmts |
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: October 2006 | 5 .\" Date: October 2006 |
5 .\" Manual: Yasm Supported Debug Formats | 6 .\" Manual: Yasm Supported Debug Formats |
6 .\" Source: Yasm | 7 .\" Source: Yasm |
| 8 .\" Language: English |
7 .\" | 9 .\" |
8 .TH "YASM_DBGFMTS" "7" "October 2006" "Yasm" "Yasm Supported Debug Formats" | 10 .TH "YASM_DBGFMTS" "7" "October 2006" "Yasm" "Yasm Supported Debug 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_dbgfmts \- Yasm Supported Debugging Formats | 22 yasm_dbgfmts \- Yasm Supported Debugging Formats |
15 .SH "SYNOPSIS" | 23 .SH "SYNOPSIS" |
16 .HP 5 | 24 .HP \w'\fByasm\fR\ 'u |
17 \fByasm\fR \fB\-g\ \fR\fB\fIdbgfmt\fR\fR \fB\fI...\fR\fR | 25 \fByasm\fR \fB\-g\ \fR\fB\fIdbgfmt\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 debugg
ing formats. The debugging information is embedded into the object file. Use of
a non\-\(lqnull\(rq | 28 The standard Yasm distribution includes a number of modules for different debugg
ing formats\&. The debugging information is embedded into the object file\&. Use
of a non\-\(lqnull\(rq |
21 debug format also causes Yasm to output all symbols to the object file (includin
g local symbols). | 29 debug format also causes Yasm to output all symbols to the object file (includin
g local symbols)\&. |
22 .PP | 30 .PP |
23 The debug format is selected on the | 31 The debug format is selected on the |
24 \fByasm\fR(1) | 32 \fByasm\fR(1) |
25 command line by use of the | 33 command line by use of the |
26 \fB\-g \fR\fB\fIdbgfmt\fR\fR | 34 \fB\-g \fR\fB\fIdbgfmt\fR\fR |
27 command line option. | 35 command line option\&. |
28 .SH "CV8" | 36 .SH "CV8" |
29 .PP | 37 .PP |
30 The CV8 debug format is used by Microsoft Visual Studio 2005 (version 8.0) and i
s completely undocumented, although it bears strong similarities to earlier Code
View formats. Yasm's support for the CV8 debug format is currently limited to ge
nerating assembly\-level line number information (to allow some level of source\
-level debugging). The CV8 debug information is stored in the .debug$S and .debu
g$T sections of the Win64 object file. | 38 The CV8 debug format is used by Microsoft Visual Studio 2005 (version 8\&.0) and
is completely undocumented, although it bears strong similarities to earlier Co
deView formats\&. Yasm\'s support for the CV8 debug format is currently limited
to generating assembly\-level line number information (to allow some level of so
urce\-level debugging)\&. The CV8 debug information is stored in the \&.debug$S
and \&.debug$T sections of the Win64 object file\&. |
31 .SH "DWARF2" | 39 .SH "DWARF2" |
32 .PP | 40 .PP |
33 The DWARF 2 debug format is a complex, well\-documented standard for debugging i
nformation. It was created to overcome shortcomings in STABS, allowing for much
more detailed and compact descriptions of data structures, data variable movemen
t, and complex language structures such as in C++. The debugging information is
stored in sections (just like normal program sections) in the object file. Yasm
supports full pass\-through of DWARF2 debugging information (e.g. from a C++ com
piler), and can also generate assembly\-level line number information. | 41 The DWARF 2 debug format is a complex, well\-documented standard for debugging i
nformation\&. It was created to overcome shortcomings in STABS, allowing for muc
h more detailed and compact descriptions of data structures, data variable movem
ent, and complex language structures such as in C++\&. The debugging information
is stored in sections (just like normal program sections) in the object file\&.
Yasm supports full pass\-through of DWARF2 debugging information (e\&.g\&. from
a C++ compiler), and can also generate assembly\-level line number information\
&. |
34 .SH "NULL" | 42 .SH "NULL" |
35 .PP | 43 .PP |
36 The | 44 The |
37 \(lqnull\(rq | 45 \(lqnull\(rq |
38 debug format is a placeholder; it adds no debugging information to the output fi
le. | 46 debug format is a placeholder; it adds no debugging information to the output fi
le\&. |
39 .SH "STABS" | 47 .SH "STABS" |
40 .PP | 48 .PP |
41 The STABS debug format is a poorly documented, semi\-standard format for debuggi
ng information in COFF and ELF object files. The debugging information is stored
as part of the object file's symbol table and thus is limited in complexity and
scope. Despite this, STABS is a common debugging format on older Unix and compa
tible systems, as well as DJGPP. | 49 The STABS debug format is a poorly documented, semi\-standard format for debuggi
ng information in COFF and ELF object files\&. The debugging information is stor
ed as part of the object file\'s symbol table and thus is limited in complexity
and scope\&. Despite this, STABS is a common debugging format on older Unix and
compatible systems, as well as DJGPP\&. |
42 .SH "SEE ALSO" | 50 .SH "SEE ALSO" |
43 .PP | 51 .PP |
44 \fByasm\fR(1), | 52 \fByasm\fR(1), |
45 \fByasm_objfmts\fR(7) | 53 \fByasm_objfmts\fR(7) |
46 .SH "AUTHOR" | 54 .SH "AUTHOR" |
47 .PP | 55 .PP |
48 \fBPeter\fR \fBJohnson\fR <peter@tortall.net> | 56 \fBPeter Johnson\fR <\&peter@tortall\&.net\&> |
49 .sp -1n | 57 .RS 4 |
50 .IP "" 3n | |
51 Author. | 58 Author. |
| 59 .RE |
52 .SH "COPYRIGHT" | 60 .SH "COPYRIGHT" |
| 61 .br |
53 Copyright \(co 2006 Peter Johnson | 62 Copyright \(co 2006 Peter Johnson |
| 63 .br |
OLD | NEW |