0
0
mirror of https://github.com/netwide-assembler/nasm.git synced 2025-10-10 00:25:06 -04:00

Update sections about debug info formats

This commit is contained in:
Charles Crayne
2007-10-24 15:30:17 -07:00
parent f6816b25bf
commit 650dc9d004

View File

@@ -537,8 +537,8 @@ of this switch does \e{not} enable output of the selected debug info format.
Use \c{-g}, see \k{opt-g}, to enable output. Use \c{-g}, see \k{opt-g}, to enable output.
A complete list of the available debug file formats for an output format A complete list of the available debug file formats for an output format
can be seen by issuing the command \i\c{nasm -f <format> -y}. (only can be seen by issuing the command \i\c{nasm -f <format> -y}. (As of 0.99.05,
"borland" in "-f obj", as of 0.98.35, but "watch this space") only "-f elf32", "-f elf64", "-f ieee", and "-f obj" provide debug information.)
See: \k{opt-y}. See: \k{opt-y}.
This should not be confused with the "-f dbg" output format option which This should not be confused with the "-f dbg" output format option which
@@ -862,8 +862,8 @@ You will need the version number if you report a bug.
Typing \c{nasm -f <option> -y} will display a list of the available Typing \c{nasm -f <option> -y} will display a list of the available
debug info formats for the given output format. The default format debug info formats for the given output format. The default format
is indicated by an asterisk. E.g. \c{nasm -f obj -y} yields \c{* borland}. is indicated by an asterisk. E.g. \c{nasm -f elf -y} yields \c{* stabs}.
(as of 0.98.35, the \e{only} debug info format implemented). (as of 0.99.05, the \e{only} debug info format implemented for this output format).
\S{opt-pfix} The \i\c{--prefix} and \i\c{--postfix} Options. \S{opt-pfix} The \i\c{--prefix} and \i\c{--postfix} Options.
@@ -4578,6 +4578,14 @@ be linked as ELF using GNU \c{ld}. If NASM is used with the
\c{-w+gnu-elf-extensions} option, a warning is issued when one of \c{-w+gnu-elf-extensions} option, a warning is issued when one of
these relocations is generated. these relocations is generated.
\S{elfdbg} Debug formats and ELF
\I{ELF, Debug formats and}
\c{ELF32} and \c{ELF64} provide debug information in \c{STABS} format.
As of 0.99.05, this information is generated only for the ".text" section.
However, in more recent versions, all executable sections are included.
(Note that only the ".text" section is executable by default.)
\H{aoutfmt} \i\c{aout}: Linux \I{a.out, Linux version}\I{linux, a.out}\c{a.out} Object Files \H{aoutfmt} \i\c{aout}: Linux \I{a.out, Linux version}\I{linux, a.out}\c{a.out} Object Files
The \c{aout} format generates \c{a.out} object files, in the form used The \c{aout} format generates \c{a.out} object files, in the form used