ADDR2LINE(1) GNU Development Tools ADDR2LINE(1)NAME
addr2line - convert addresses into file names and line
numbers.
SYNOPSIS
addr2line [-b bfdname|--target=bfdname]
[-C|--demangle[=style]]
[-e filename|--exe=filename]
[-f|--functions] [-s|--basename]
[-i|--inlines]
[-H|--help] [-V|--version]
[addr addr ...]
DESCRIPTION
addr2line translates program addresses into file names and
line numbers. Given an address and an executable, it uses
the debugging information in the executable to figure out
which file name and line number are associated with a given
address.
The executable to use is specified with the -e option. The
default is the file a.out.
addr2line has two modes of operation.
In the first, hexadecimal addresses are specified on the
command line, and addr2line displays the file name and line
number for each address.
In the second, addr2line reads hexadecimal addresses from
standard input, and prints the file name and line number for
each address on standard output. In this mode, addr2line
may be used in a pipe to convert dynamically chosen
addresses.
The format of the output is FILENAME:LINENO. The file name
and line number for each address is printed on a separate
line. If the -f option is used, then each FILENAME:LINENO
line is preceded by a FUNCTIONNAME line which is the name of
the function containing the address.
If the file name or function name can not be determined,
addr2line will print two question marks in their place. If
the line number can not be determined, addr2line will print
0.
OPTIONS
The long and short forms of options, shown here as
alternatives, are equivalent.
-b bfdname
--target=bfdname
binutils-050707 2011-08-18 1
ADDR2LINE(1) GNU Development Tools ADDR2LINE(1)
Specify that the object-code format for the object files
is bfdname.
-C
--demangle[=style]
Decode (demangle) low-level symbol names into user-level
names. Besides removing any initial underscore prepended
by the system, this makes C++ function names readable.
Different compilers have different mangling styles. The
optional demangling style argument can be used to choose
an appropriate demangling style for your compiler.
-e filename
--exe=filename
Specify the name of the executable for which addresses
should be translated. The default file is a.out.
-f
--functions
Display function names as well as file and line number
information.
-s
--basenames
Display only the base of each file name.
-i
--inlines
If the address belongs to a function that was inlined,
the source information for all enclosing scopes back to
the first non-inlined function will also be printed.
For example, if "main" inlines "callee1" which inlines
"callee2", and address is from "callee2", the source
information for "callee1" and "main" will also be
printed.
SEE ALSO
Info entries for binutils.
COPYRIGHT
Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License, Version 1.1 or any later version published by the
Free Software Foundation; with no Invariant Sections, with
no Front-Cover Texts, and with no Back-Cover Texts. A copy
of the license is included in the section entitled ``GNU
Free Documentation License''.
binutils-050707 2011-08-18 2