darkkirb/old-cross-binutils
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Clarify doc on addr2line output.

Browse source 
binutils/
	* doc/binutils.texi: Clarify addr2line output.
This commit is contained in:
Tristan Gingold 2014-07-03 17:30:49 +02:00
parent 92c3b204c7
commit 8d112f9ecb
2 changed files with 27 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
binutils/ChangeLog
View file

@ -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> 2014-07-01 Alan Modra <amodra@gmail.com>
* objdump.c (dump_bfd_header): Don't print HAS_LOAD_PAGE. * objdump.c (dump_bfd_header): Don't print HAS_LOAD_PAGE.

39
binutils/doc/binutils.texi
View file

@ -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 address on standard output. In this mode, @command{addr2line} may be used
in a pipe to convert dynamically chosen addresses. in a pipe to convert dynamically chosen addresses.
The format of the output is @samp{FILENAME:LINENO}. The file name and The format of the output is @samp{FILENAME:LINENO}. By default
line number for each input address is printed on separate lines. each input address generates one line of output.
If the @option{-f} option is used, then each @samp{FILENAME:LINENO} Two options can generate additional lines before each
line is preceded by @samp{FUNCTIONNAME} which is the name of the @samp{FILENAME:LINENO} line (in that order).
function containing the address.
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 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 present there because of inlining by the compiler then additional
@samp{@{FUNCTIONNAME@} FILENAME:LINENO} information for the inlining lines are displayed afterwards. One or two extra lines (if the
function will be displayed afterwards. This continues recursively @option{-f} option is used) are displayed for each inlined function.
until there is no more inlining to report.
If the @option{-a} option is used then the output is prefixed by the Alternatively if the @option{-p} option is used then each input
input address. address generates a single, long, output line containing the address,
the function name, the file name and the line number. If the
If the @option{-p} option is used then the output for each input @option{-i} option has also been used then any inlined functions will
address is displayed on one, possibly quite long, line. If be displayed in the same manner, but on separate lines, and prefixed
@option{-p} is not used then the output is broken up into multiple by the text @samp{(inlined by)}.
lines, based on the paragraphs above.
If the file name or function name can not be determined, If the file name or function name can not be determined,
@command{addr2line} will print two question marks in their place. If the @command{addr2line} will print two question marks in their place. If the