version 1, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
ADDR2LINE |
|
|
2 |
!!!ADDR2LINE |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
SEE ALSO |
|
|
8 |
COPYRIGHT |
|
|
9 |
---- |
|
|
10 |
!!NAME |
|
|
11 |
|
|
|
12 |
|
|
|
13 |
addr2line - convert addresses into file names and line numbers. |
|
|
14 |
!!SYNOPSIS |
|
|
15 |
|
|
|
16 |
|
|
|
17 |
addr2line [[__-b__ |
|
|
18 |
''bfdname''__--target=__''bfdname''] |
|
|
19 |
[[__-C--demangle__[[=''style''] [[__-e__ |
|
|
20 |
''filename''__--exe=__''filename''] |
|
|
21 |
[[__-f--functions__] [[__-s--basename__] |
|
|
22 |
[[__-H--help__] [[__-V--version__] [[addr addr |
|
|
23 |
...] |
|
|
24 |
!!DESCRIPTION |
|
|
25 |
|
|
|
26 |
|
|
|
27 |
__addr2line__ translates program addresses into file |
|
|
28 |
names and line numbers. Given an address and an executable, |
|
|
29 |
it uses the debugging information in the executable to |
|
|
30 |
figure out which file name and line number are associated |
|
|
31 |
with a given address. |
|
|
32 |
|
|
|
33 |
|
|
|
34 |
The executable to use is specified with the __-e__ |
|
|
35 |
option. The default is the file ''a.out''. |
|
|
36 |
|
|
|
37 |
|
|
|
38 |
__addr2line__ has two modes of operation. |
|
|
39 |
|
|
|
40 |
|
|
|
41 |
In the first, hexadecimal addresses are specified on the |
|
|
42 |
command line, and __addr2line__ displays the file name |
|
|
43 |
and line number for each address. |
|
|
44 |
|
|
|
45 |
|
|
|
46 |
In the second, __addr2line__ reads hexadecimal addresses |
|
|
47 |
from standard input, and prints the file name and line |
|
|
48 |
number for each address on standard output. In this mode, |
|
|
49 |
__addr2line__ may be used in a pipe to convert |
|
|
50 |
dynamically chosen addresses. |
|
|
51 |
|
|
|
52 |
|
|
|
53 |
The format of the output is |
|
|
54 |
__FILENAME:LINENO__ . The file name and |
|
|
55 |
line number for each address is printed on a separate line. |
|
|
56 |
If the __-f__ option is used, then each |
|
|
57 |
__FILENAME:LINENO__ line is preceded by a |
|
|
58 |
__FUNCTIONNAME__ line which is the name of |
|
|
59 |
the function containing the address. |
|
|
60 |
|
|
|
61 |
|
|
|
62 |
If the file name or function name can not be determined, |
|
|
63 |
__addr2line__ will print two question marks in their |
|
|
64 |
place. If the line number can not be determined, |
|
|
65 |
__addr2line__ will print 0. |
|
|
66 |
!!OPTIONS |
|
|
67 |
|
|
|
68 |
|
|
|
69 |
The long and short forms of options, shown here as |
|
|
70 |
alternatives, are equivalent. |
|
|
71 |
|
|
|
72 |
|
|
|
73 |
__-b__ ''bfdname'' |
|
|
74 |
|
|
|
75 |
|
|
|
76 |
__--target=__''bfdname'' |
|
|
77 |
|
|
|
78 |
|
|
|
79 |
Specify that the object-code format for the object files is |
|
|
80 |
''bfdname''. |
|
|
81 |
|
|
|
82 |
|
|
|
83 |
__-C__ |
|
|
84 |
|
|
|
85 |
|
|
|
86 |
__--demangle[[=__''style''__]__ |
|
|
87 |
|
|
|
88 |
|
|
|
89 |
Decode (''demangle'') low-level symbol names into |
|
|
90 |
user-level names. Besides removing any initial underscore |
|
|
91 |
prepended by the system, this makes C ++ |
|
|
92 |
function names readable. Different compilers have different |
|
|
93 |
mangling styles. The optional demangling style argument can |
|
|
94 |
be used to choose an appropriate demangling style for your |
|
|
95 |
compiler. |
|
|
96 |
|
|
|
97 |
|
|
|
98 |
__-e__ ''filename'' |
|
|
99 |
|
|
|
100 |
|
|
|
101 |
__--exe=__''filename'' |
|
|
102 |
|
|
|
103 |
|
|
|
104 |
Specify the name of the executable for which addresses |
|
|
105 |
should be translated. The default file is |
|
|
106 |
''a.out''. |
|
|
107 |
|
|
|
108 |
|
|
|
109 |
__-f__ |
|
|
110 |
|
|
|
111 |
|
|
|
112 |
__--functions__ |
|
|
113 |
|
|
|
114 |
|
|
|
115 |
Display function names as well as file and line number |
|
|
116 |
information. |
|
|
117 |
|
|
|
118 |
|
|
|
119 |
__-s__ |
|
|
120 |
|
|
|
121 |
|
|
|
122 |
__--basenames__ |
|
|
123 |
|
|
|
124 |
|
|
|
125 |
Display only the base of each file name. |
|
|
126 |
!!SEE ALSO |
|
|
127 |
|
|
|
128 |
|
|
|
129 |
Info entries for ''binutils''. |
|
|
130 |
!!COPYRIGHT |
|
|
131 |
|
|
|
132 |
|
|
|
133 |
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, |
|
|
134 |
2001, 2002 Free Software Foundation, Inc. |
|
|
135 |
|
|
|
136 |
|
|
|
137 |
Permission is granted to copy, distribute and/or modify this |
|
|
138 |
document under the terms of the GNU Free |
|
|
139 |
Documentation License, Version 1.1 or any later version |
|
|
140 |
published by the Free Software Foundation; with no Invariant |
|
|
141 |
Sections, with no Front-Cover Texts, and with no Back-Cover |
|
|
142 |
Texts. A copy of the license is included in the section |
|
|
143 |
entitled `` GNU Free Documentation |
|
|
144 |
License''. |
|
|
145 |
---- |