View Source: addr2line(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

ADDR2LINE
!!!ADDR2LINE
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
COPYRIGHT
----
!!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__]
[[__-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''


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.
!!SEE ALSO


Info entries for ''binutils''.
!!COPYRIGHT


Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000,
2001, 2002 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''.
----

One page links to addr2line(1):

Man1a

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Monday, June 3, 2002 6:49:55 pm by "perry"

Edit PageHistory Diff Info LikePages