Penguin
Blame: addr2line(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of addr2line(1) version 1, including all changes. View license author blame.
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 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.