@ -118,7 +118,7 @@ Demangle encoded C++ symbols (on MS-DOS, this program is named
@code{cxxfilt})
@code{cxxfilt})
@item addr2line
@item addr2line
Convert addresses into file names and line numbers
Convert addresses or symbol+offset into file names and line numbers
@item windres
@item windres
Manipulate Windows resources
Manipulate Windows resources
@ -146,7 +146,7 @@ in the section entitled ``GNU Free Documentation License''.
* strip:: Discard symbols
* strip:: Discard symbols
* c++filt:: Filter to demangle encoded C++ symbols
* c++filt:: Filter to demangle encoded C++ symbols
* cxxfilt: c++filt. MS-DOS name for c++filt
* cxxfilt: c++filt. MS-DOS name for c++filt
* addr2line:: Convert addresses to file and line
* addr2line:: Convert addresses or symbol+offset to file and line
* windmc:: Generator for Windows message resources
* windmc:: Generator for Windows message resources
* windres:: Manipulate Windows resources
* windres:: Manipulate Windows resources
* dlltool:: Create files needed to build and use DLLs
* dlltool:: Create files needed to build and use DLLs
@ -3902,7 +3902,7 @@ c++filt @var{option} @var{symbol}
@kindex addr2line
@kindex addr2line
@cindex address to file name and line number
@cindex address to file name and line number
@c man title addr2line convert addresses into file names and line numbers
@c man title addr2line convert addresses or symbol+offset into file names and line numbers
@smallexample
@smallexample
@c man begin SYNOPSIS addr2line
@c man begin SYNOPSIS addr2line
@ -3923,8 +3923,8 @@ addr2line [@option{-a}|@option{--addresses}]
@c man begin DESCRIPTION addr2line
@c man begin DESCRIPTION addr2line
@command{addr2line} translates addresses into file names and line numbers.
@command{addr2line} translates addresses or symbol+offset into file names and line numbers.
Given an address in an executable or an offset in a section of a relocatable
Given an address or symbol+offset in an executable or an offset in a section of a relocatable
object, it uses the debugging information to figure out which file name and
object, it uses the debugging information to figure out which file name and
line number are associated with it.
line number are associated with it.
@ -3934,11 +3934,11 @@ object to use is specified with the @option{-j} option.
@command{addr2line} has two modes of operation.
@command{addr2line} has two modes of operation.
In the first, hexadecimal addresses are specified on the command line,
In the first, hexadecimal addresses or symbol+offset are specified on the command line,
and @command{addr2line} displays the file name and line number for each
and @command{addr2line} displays the file name and line number for each
address.
address.
In the second, @command{addr2line} reads hexadecimal addresses from
In the second, @command{addr2line} reads hexadecimal addresses or symbol+offset from
standard input, and prints the file name and line number for each
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.
@ -3975,6 +3975,10 @@ 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
line number can not be determined, @command{addr2line} will print 0.
line number can not be determined, @command{addr2line} will print 0.
When symbol+offset is used, +offset is optional, except when the symbol
is ambigious with a hex number. The resolved symbols can be mangled
or unmangled, except unmangled symbols with + are not allowed.
@c man end
@c man end
@c man begin OPTIONS addr2line
@c man begin OPTIONS addr2line