1YASM_DBGFMTS(7)          Yasm Supported Debug Formats          YASM_DBGFMTS(7)
2
3
4

NAME

6       yasm_dbgfmts - Yasm Supported Debugging Formats
7

SYNOPSIS

9       yasm -g dbgfmt ...
10

DESCRIPTION

12       The standard Yasm distribution includes a number of modules for
13       different debugging formats. The debugging information is embedded into
14       the object file. Use of a non-“null” debug format also causes Yasm to
15       output all symbols to the object file (including local symbols).
16
17       The debug format is selected on the yasm(1) command line by use of the
18       -g dbgfmt command line option.
19

CV8

21       The CV8 debug format is used by Microsoft Visual Studio 2005 (version
22       8.0) and is completely undocumented, although it bears strong
23       similarities to earlier CodeView formats. Yasm's support for the CV8
24       debug format is currently limited to generating assembly-level line
25       number information (to allow some level of source-level debugging). The
26       CV8 debug information is stored in the .debug$S and .debug$T sections
27       of the Win64 object file.
28

DWARF2

30       The DWARF 2 debug format is a complex, well-documented standard for
31       debugging information. It was created to overcome shortcomings in
32       STABS, allowing for much more detailed and compact descriptions of data
33       structures, data variable movement, and complex language structures
34       such as in C++. The debugging information is stored in sections (just
35       like normal program sections) in the object file. Yasm supports full
36       pass-through of DWARF2 debugging information (e.g. from a C++
37       compiler), and can also generate assembly-level line number
38       information.
39

NULL

41       The “null” debug format is a placeholder; it adds no debugging
42       information to the output file.
43

STABS

45       The STABS debug format is a poorly documented, semi-standard format for
46       debugging information in COFF and ELF object files. The debugging
47       information is stored as part of the object file's symbol table and
48       thus is limited in complexity and scope. Despite this, STABS is a
49       common debugging format on older Unix and compatible systems, as well
50       as DJGPP.
51

SEE ALSO

53       yasm(1), yasm_objfmts(7)
54

AUTHOR

56       Peter Johnson <peter@tortall.net>
57          Author.
58

60       Copyright © 2006 Peter Johnson
61
62
63
64Yasm                             October 2006                  YASM_DBGFMTS(7)
Impressum