scc-addr2line.man (1577B)
1 .TH SCC-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 .IP 21 .EX 22 filename:linenumber 23 .EE 24 .PP 25 If no addresses are given as arguments, 26 .B scc-addr2line 27 reads addresses from standard input, one per line, and translates each 28 one. This mode continues until an error is encountered or end-of-file 29 is reached. 30 .SH OPTIONS 31 .TP 32 .BI \-e " file" 33 Use 34 .I file 35 as the executable to translate addresses from. 36 If this option is not specified, 37 .B scc-addr2line 38 uses 39 .B a.out 40 as the default executable. 41 .SH OPERANDS 42 .TP 43 .I addr 44 A hexadecimal address to translate. Multiple addresses may be specified 45 as separate arguments and will be translated in order. 46 .SH EXAMPLES 47 Translate a single address in the default executable: 48 .IP 49 .EX 50 scc-addr2line 0x4005a0 51 .EE 52 .PP 53 Translate multiple addresses in a specific executable: 54 .IP 55 .EX 56 scc-addr2line \-e myprog 0x4005a0 0x400620 57 .EE 58 .PP 59 Read addresses from standard input: 60 .IP 61 .EX 62 echo 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)