scc

simple c99 compiler
git clone git://git.simple-cc.org/scc
Log | Files | Refs | Submodules | README | LICENSE

scc-addr2line.1 (1875B)

      1 .TH ADDR2LINE 1 scc\-VERSION
      2 .SH NAME
      3 scc-addr2line \- translate addresses into file names and line numbers
      4 .SH SYNOPSIS
      5 .B scc-addr2line
      6 .RB [ \-e
      7 .IR file ]
      8 .RI [ addr ...]
      9 .SH DESCRIPTION
     10 .B scc-addr2line
     11 translates program addresses into file names and line numbers.
     12 Given an address in an executable, it uses the debug information in
     13 the object file to determine which source file and line number
     14 correspond to that address.
     15 .PP
     16 Addresses are specified in hexadecimal. For each address,
     17 .B scc-addr2line
     18 prints the corresponding source file name and line number to standard
     19 output, in the form:
     20 .PP
     21 .in +4n
     22 .EX
     23 filename:linenumber
     24 .EE
     25 .in
     26 .PP
     27 If no addresses are given as arguments,
     28 .B scc-addr2line
     29 reads addresses from standard input, one per line, and translates each
     30 one. This mode continues until an error is encountered or end-of-file
     31 is reached.
     32 .SH OPTIONS
     33 .TP
     34 .BI \-e " file"
     35 Use
     36 .I file
     37 as the executable to translate addresses from.
     38 If this option is not specified,
     39 .B scc-addr2line
     40 uses
     41 .B a.out
     42 as the default executable.
     43 .SH OPERANDS
     44 .TP
     45 .I addr
     46 A hexadecimal address to translate. Multiple addresses may be specified
     47 as separate arguments and will be translated in order.
     48 .SH EXIT STATUS
     49 .TP
     50 .B 0
     51 Successful completion.
     52 .TP
     53 .B >0
     54 An error occurred, such as an unrecognized file format, an invalid
     55 address, or no matching debug information found.
     56 .SH EXAMPLES
     57 Translate a single address in the default executable:
     58 .IP
     59 .EX
     60 scc-addr2line 0x4005a0
     61 .EE
     62 .PP
     63 Translate multiple addresses in a specific executable:
     64 .IP
     65 .EX
     66 scc-addr2line \-e myprog 0x4005a0 0x400620
     67 .EE
     68 .PP
     69 Read addresses from standard input:
     70 .IP
     71 .EX
     72 echo 0x4005a0 | scc-addr2line \-e myprog
     73 .EE
     74 .SH AUTHORS
     75 See the LICENSE file for the authors.
     76 .SH LICENSE
     77 See the LICENSE file for the terms of redistribution.
     78 .SH SEE ALSO
     79 .BR scc-nm (1),
     80 .BR scc-objdump (1),
     81 .BR scc-strip (1),
     82 .BR scc-cc (1)