From: Tristan Gingold Date: Thu, 3 Jul 2014 15:30:49 +0000 (+0200) Subject: Clarify doc on addr2line output. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=8d112f9ecbe59b0eee3ec636a86891a6a82e4d9b;p=binutils-gdb.git Clarify doc on addr2line output. binutils/ * doc/binutils.texi: Clarify addr2line output. --- diff --git a/binutils/ChangeLog b/binutils/ChangeLog index e81c97a7c25..c5a5c20cbdb 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -1,3 +1,7 @@ +2014-07-03 Tristan Gingold + + * doc/binutils.texi: Clarify addr2line output. + 2014-07-01 Alan Modra * objdump.c (dump_bfd_header): Don't print HAS_LOAD_PAGE. diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi index b674b9d03aa..3874f25a3b6 100644 --- a/binutils/doc/binutils.texi +++ b/binutils/doc/binutils.texi @@ -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. - -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. +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. + +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