Go to main content

man pages section 7: Standards, Environments, Macros, Character Sets, and Miscellany

Exit Print View

Updated: Thursday, June 13, 2019
 
 

yasm_dbgfmts (7)

Name

yasm_dbgfmts - Yasm Supported Debugging Formats

Synopsis

yasm -g dbgfmt ...

Description

Yasm Supported Debug Formats                                   YASM_DBGFMTS(7)



NAME
       yasm_dbgfmts - Yasm Supported Debugging Formats

SYNOPSIS
       yasm -g dbgfmt ...

DESCRIPTION
       The standard Yasm distribution includes a number of modules for
       different debugging formats. The debugging information is embedded into
       the object file. Use of a non-"null" debug format also causes Yasm to
       output all symbols to the object file (including local symbols).

       The debug format is selected on the yasm(1) command line by use of the
       -g dbgfmt command line option.

CV8
       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 CodeView formats. Yasm's support for the CV8
       debug format is currently limited to generating assembly-level line
       number information (to allow some level of source-level debugging). The
       CV8 debug information is stored in the .debug$S and .debug$T sections
       of the Win64 object file.

DWARF2
       The DWARF 2 debug format is a complex, well-documented standard for
       debugging information. It was created to overcome shortcomings in
       STABS, allowing for much more detailed and compact descriptions of data
       structures, data variable movement, 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.

NULL
       The "null" debug format is a placeholder; it adds no debugging
       information to the output file.

STABS
       The STABS debug format is a poorly documented, semi-standard format for
       debugging 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 compatible systems, as well
       as DJGPP.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | developer/yasm        |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+
SEE ALSO
       yasm(1), yasm_objfmts(7)

AUTHOR
       Peter Johnson <peter@tortall.net>
           Author.

COPYRIGHT
       Copyright (C) 2006 Peter Johnson



NOTES
       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz

       Further information about this software can be found on the open source
       community website at http://yasm.tortall.net/.



Yasm                             October 2006                  YASM_DBGFMTS(7)