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]
              [-e filename | --exe=filename] [-f|--functions]
              [-s|--basenames] [-H|--help] [-V|--version]
              [addraddr...]

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 giv-
       en address.

       The  executable  to  use  is specified with the -e option.
       The default is 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,  ad-
       dr2line  may be used in a pipe to convert dynamically cho-
       sen addresses.

       The format of the output  is  FILENAME:LINENO.   The  file
       name and line number for each address is printed on a sep-
       arate line.  If the -f option is  used,  then  each  FILE-
       NAME: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
       -b bfdname

       --target=bfdname
              Specify the object-code format for the object files
              to be bfdname.

       -C

       --demangle
              Decode (demangle) low-level symbol names into user-
              level  names.   Besides removing any initial under-
              score prepended by the system, this makes C++ func-
              tion names readable.

       -e filename

       --exe=filename
              Specify  the  name  of the executable for which ad-
              dresses 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
       `binutils' entry in info; The GNU Binary Utilities, Roland
       H. Pesch (October 1991).

Cygnus Solutions          27 March 1997                         1