scc

 1.TH SCC-ADDR2LINE 1 scc\-VERSION
 2.SH NAME
 3scc-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
11translates program addresses into file names and line numbers.
12Given an address in an executable, it uses the debug information in
13the object file to determine which source file and line number
14correspond to that address.
15.PP
16Addresses are specified in hexadecimal. For each address,
17.B scc-addr2line
18prints the corresponding source file name and line number to standard
19output, in the form:
20.IP
21.EX
22filename:linenumber
23.EE
24.PP
25If no addresses are given as arguments,
26.B scc-addr2line
27reads addresses from standard input, one per line, and translates each
28one. This mode continues until an error is encountered or end-of-file
29is reached.
30.SH OPTIONS
31.TP
32.BI \-e " file"
33Use
34.I file
35as the executable to translate addresses from.
36If this option is not specified,
37.B scc-addr2line
38uses
39.B a.out
40as the default executable.
41.SH OPERANDS
42.TP
43.I addr
44A hexadecimal address to translate. Multiple addresses may be specified
45as separate arguments and will be translated in order.
46.SH EXAMPLES
47Translate a single address in the default executable:
48.IP
49.EX
50scc-addr2line 0x4005a0
51.EE
52.PP
53Translate multiple addresses in a specific executable:
54.IP
55.EX
56scc-addr2line \-e myprog 0x4005a0 0x400620
57.EE
58.PP
59Read addresses from standard input:
60.IP
61.EX
62echo 0x4005a0 | scc-addr2line \-e myprog
63.EE
64.SH SEE ALSO
65.BR scc-nm (1),
66.BR scc-objdump (1),
67.BR scc-strip (1),
68.BR scc-cc (1)