mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-11-28 20:43:45 +08:00
Clarify doc on addr2line output.
binutils/ * doc/binutils.texi: Clarify addr2line output.
This commit is contained in:
parent
92c3b204c7
commit
8d112f9ecb
@ -1,3 +1,7 @@
|
||||
2014-07-03 Tristan Gingold <gingold@adacore.com>
|
||||
|
||||
* doc/binutils.texi: Clarify addr2line output.
|
||||
|
||||
2014-07-01 Alan Modra <amodra@gmail.com>
|
||||
|
||||
* objdump.c (dump_bfd_header): Don't print HAS_LOAD_PAGE.
|
||||
|
@ -3214,26 +3214,33 @@ standard input, and prints the file name and line number for each
|
||||
address on standard output. In this mode, @command{addr2line} may be used
|
||||
in a pipe to convert dynamically chosen addresses.
|
||||
|
||||
The format of the output is @samp{FILENAME:LINENO}. The file name and
|
||||
line number for each input address is printed on separate lines.
|
||||
The format of the output is @samp{FILENAME:LINENO}. By default
|
||||
each input address generates one line of output.
|
||||
|
||||
If the @option{-f} option is used, then each @samp{FILENAME:LINENO}
|
||||
line is preceded by @samp{FUNCTIONNAME} which is the name of the
|
||||
function containing the address.
|
||||
Two options can generate additional lines before each
|
||||
@samp{FILENAME:LINENO} line (in that order).
|
||||
|
||||
If the @option{-a} option is used then a line with the input address
|
||||
is displayed.
|
||||
|
||||
If the @option{-f} option is used, then a line with the
|
||||
@samp{FUNCTIONNAME} is displayed. This is the name of the function
|
||||
containing the address.
|
||||
|
||||
One option can generate additional lines after the
|
||||
@samp{FILENAME:LINENO} line.
|
||||
|
||||
If the @option{-i} option is used and the code at the given address is
|
||||
present there because of inlining by the compiler then the
|
||||
@samp{@{FUNCTIONNAME@} FILENAME:LINENO} information for the inlining
|
||||
function will be displayed afterwards. This continues recursively
|
||||
until there is no more inlining to report.
|
||||
present there because of inlining by the compiler then additional
|
||||
lines are displayed afterwards. One or two extra lines (if the
|
||||
@option{-f} option is used) are displayed for each inlined function.
|
||||
|
||||
If the @option{-a} option is used then the output is prefixed by the
|
||||
input address.
|
||||
|
||||
If the @option{-p} option is used then the output for each input
|
||||
address is displayed on one, possibly quite long, line. If
|
||||
@option{-p} is not used then the output is broken up into multiple
|
||||
lines, based on the paragraphs above.
|
||||
Alternatively if the @option{-p} option is used then each input
|
||||
address generates a single, long, output line containing the address,
|
||||
the function name, the file name and the line number. If the
|
||||
@option{-i} option has also been used then any inlined functions will
|
||||
be displayed in the same manner, but on separate lines, and prefixed
|
||||
by the text @samp{(inlined by)}.
|
||||
|
||||
If the file name or function name can not be determined,
|
||||
@command{addr2line} will print two question marks in their place. If the
|
||||
|
Loading…
Reference in New Issue
Block a user