binutils/addr2line.1

   1 .rn '' }`
   2 ''' $RCSfile$$Revision$$Date$
   3 '''
   4 ''' $Log$
   5 ''' Revision 1.5  2001/03/25 20:32:25  nickc
   6 ''' Automate generate on man pages
   7 '''
   8 '''
   9 .de Sh
  10 .br
  11 .if t .Sp
  12 .ne 5
  13 .PP
  14 \fB\\$1\fR
  15 .PP
  16 ..
  17 .de Sp
  18 .if t .sp .5v
  19 .if n .sp
  20 ..
  21 .de Ip
  22 .br
  23 .ie \\n(.$>=3 .ne \\$3
  24 .el .ne 3
  25 .IP "\\$1" \\$2
  26 ..
  27 .de Vb
  28 .ft CW
  29 .nf
  30 .ne \\$1
  31 ..
  32 .de Ve
  33 .ft R
  34
  35 .fi
  36 ..
  37 '''
  38 '''
  39 '''     Set up \*(-- to give an unbreakable dash;
  40 '''     string Tr holds user defined translation string.
  41 '''     Bell System Logo is used as a dummy character.
  42 '''
  43 .tr \(*W-|\(bv\*(Tr
  44 .ie n \{\
  45 .ds -- \(*W-
  46 .ds PI pi
  47 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  48 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
  49 .ds L" ""
  50 .ds R" ""
  51 '''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
  52 '''   \*(L" and \*(R", except that they are used on ".xx" lines,
  53 '''   such as .IP and .SH, which do another additional levels of
  54 '''   double-quote interpretation
  55 .ds M" """
  56 .ds S" """
  57 .ds N" """""
  58 .ds T" """""
  59 .ds L' '
  60 .ds R' '
  61 .ds M' '
  62 .ds S' '
  63 .ds N' '
  64 .ds T' '
  65 'br\}
  66 .el\{\
  67 .ds -- \(em\|
  68 .tr \*(Tr
  69 .ds L" ``
  70 .ds R" ''
  71 .ds M" ``
  72 .ds S" ''
  73 .ds N" ``
  74 .ds T" ''
  75 .ds L' `
  76 .ds R' '
  77 .ds M' `
  78 .ds S' '
  79 .ds N' `
  80 .ds T' '
  81 .ds PI \(*p
  82 'br\}
  83 .\"     If the F register is turned on, we'll generate
  84 .\"     index entries out stderr for the following things:
  85 .\"             TH      Title
  86 .\"             SH      Header
  87 .\"             Sh      Subsection
  88 .\"             Ip      Item
  89 .\"             X<>     Xref  (embedded
  90 .\"     Of course, you have to process the output yourself
  91 .\"     in some meaninful fashion.
  92 .if \nF \{
  93 .de IX
  94 .tm Index:\\$1\t\\n%\t"\\$2"
  95 ..
  96 .nr % 0
  97 .rr F
  98 .\}
  99 .TH ADDR2LINE.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
 100 .UC
 101 .if n .hy 0
 102 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 103 .de CQ          \" put $1 in typewriter font
 104 .ft CW
 105 'if n "\c
 106 'if t \\&\\$1\c
 107 'if n \\&\\$1\c
 108 'if n \&"
 109 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
 110 '.ft R
 111 ..
 112 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
 113 .       \" AM - accent mark definitions
 114 .bd B 3
 115 .       \" fudge factors for nroff and troff
 116 .if n \{\
 117 .       ds #H 0
 118 .       ds #V .8m
 119 .       ds #F .3m
 120 .       ds #[ \f1
 121 .       ds #] \fP
 122 .\}
 123 .if t \{\
 124 .       ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 125 .       ds #V .6m
 126 .       ds #F 0
 127 .       ds #[ \&
 128 .       ds #] \&
 129 .\}
 130 .       \" simple accents for nroff and troff
 131 .if n \{\
 132 .       ds ' \&
 133 .       ds ` \&
 134 .       ds ^ \&
 135 .       ds , \&
 136 .       ds ~ ~
 137 .       ds ? ?
 138 .       ds ! !
 139 .       ds /
 140 .       ds q
 141 .\}
 142 .if t \{\
 143 .       ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 144 .       ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 145 .       ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 146 .       ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 147 .       ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 148 .       ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
 149 .       ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
 150 .       ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 151 .       ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
 152 .\}
 153 .       \" troff and (daisy-wheel) nroff accents
 154 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 155 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 156 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
 157 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
 158 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
 159 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
 160 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 161 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 162 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 163 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 164 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 165 .ds ae a\h'-(\w'a'u*4/10)'e
 166 .ds Ae A\h'-(\w'A'u*4/10)'E
 167 .ds oe o\h'-(\w'o'u*4/10)'e
 168 .ds Oe O\h'-(\w'O'u*4/10)'E
 169 .       \" corrections for vroff
 170 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 171 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 172 .       \" for low resolution devices (crt and lpr)
 173 .if \n(.H>23 .if \n(.V>19 \
 174 \{\
 175 .       ds : e
 176 .       ds 8 ss
 177 .       ds v \h'-1'\o'\(aa\(ga'
 178 .       ds _ \h'-1'^
 179 .       ds . \h'-1'.
 180 .       ds 3 3
 181 .       ds o a
 182 .       ds d- d\h'-1'\(ga
 183 .       ds D- D\h'-1'\(hy
 184 .       ds th \o'bp'
 185 .       ds Th \o'LP'
 186 .       ds ae ae
 187 .       ds Ae AE
 188 .       ds oe oe
 189 .       ds Oe OE
 190 .\}
 191 .rm #[ #] #H #V #F C
 192 .SH "NAME"
 193 addr2line \- convert addresses into file names and line numbers.
 194 .SH "SYNOPSIS"
 195 addr2line [ \-b \fIbfdname\fR | --target=\fIbfdname\fR ]
 196           [ \-C | --demangle[=\fIstyle\fR ]
 197           [ \-e \fIfilename\fR | --exe=\fIfilename\fR ]
 198           [ \-f | --functions ] [ \-s | --basename ]
 199           [ \-H | --help ] [ \-V | --version ]
 200           [ addr addr ... ]
 201 .SH "DESCRIPTION"
 202 \f(CWaddr2line\fR translates program addresses into file names and line
 203 numbers.  Given an address and an executable, it uses the debugging
 204 information in the executable to figure out which file name and line
 205 number are associated with a given address.
 206 .PP
 207 The executable to use is specified with the \f(CW-e\fR option.  The
 208 default is the file \fIa.out\fR.
 209 .PP
 210 \f(CWaddr2line\fR has two modes of operation.
 211 .PP
 212 In the first, hexadecimal addresses are specified on the command line,
 213 and \f(CWaddr2line\fR displays the file name and line number for each
 214 address.
 215 .PP
 216 In the second, \f(CWaddr2line\fR reads hexadecimal addresses from
 217 standard input, and prints the file name and line number for each
 218 address on standard output.  In this mode, \f(CWaddr2line\fR may be used
 219 in a pipe to convert dynamically chosen addresses.
 220 .PP
 221 The format of the output is \fBFILENAME:LINENO\fR.  The file name and
 222 line number for each address is printed on a separate line.  If the
 223 \f(CW-f\fR option is used, then each \fBFILENAME:LINENO\fR line is
 224 preceded by a \fBFUNCTIONNAME\fR line which is the name of the function
 225 containing the address.
 226 .PP
 227 If the file name or function name can not be determined,
 228 \f(CWaddr2line\fR will print two question marks in their place.  If the
 229 line number can not be determined, \f(CWaddr2line\fR will print 0.
 230 .SH "OPTIONS"
 231 The long and short forms of options, shown here as alternatives, are
 232 equivalent.
 233 .Ip "\f(CW-b \fIbfdname\fR\fR" 4
 234 .Ip "\f(CW--target=\fIbfdname\fR\fR" 4
 235 Specify that the object-code format for the object files is
 236 \fIbfdname\fR.
 237 .Ip "\f(CW-C\fR" 4
 238 .Ip "\f(CW--demangle[=\fIstyle\fR]\fR" 4
 239 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
 240 Besides removing any initial underscore prepended by the system, this
 241 makes \*(C+ function names readable.  Different compilers have different
 242 mangling styles. The optional demangling style argument can be used to
 243 choose an appropriate demangling style for your compiler.
 244 .Ip "\f(CW-e \fIfilename\fR\fR" 4
 245 .Ip "\f(CW--exe=\fIfilename\fR\fR" 4
 246 Specify the name of the executable for which addresses should be
 247 translated.  The default file is \fIa.out\fR.
 248 .Ip "\f(CW-f\fR" 4
 249 .Ip "\f(CW--functions\fR" 4
 250 Display function names as well as file and line number information.
 251 .Ip "\f(CW-s\fR" 4
 252 .Ip "\f(CW--basenames\fR" 4
 253 Display only the base of each file name.
 254 .SH "SEE ALSO"
 255 Info entries for \fIbinutils\fR.
 256 .SH "COPYRIGHT"
 257 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 258 .PP
 259 Permission is granted to copy, distribute and/or modify this document
 260 under the terms of the GNU Free Documentation License, Version 1.1
 261 or any later version published by the Free Software Foundation;
 262 with no Invariant Sections, with no Front-Cover Texts, and with no
 263 Back-Cover Texts.  A copy of the license is included in the
 264 section entitled \*(L"GNU Free Documentation License\*(R".
 265
 266 .rn }` ''
 267 .IX Title "ADDR2LINE.1 1"
 268 .IX Name "addr2line - convert addresses into file names and line numbers."
 269
 270 .IX Header "NAME"
 271
 272 .IX Header "SYNOPSIS"
 273
 274 .IX Header "DESCRIPTION"
 275
 276 .IX Header "OPTIONS"
 277
 278 .IX Item "\f(CW-b \fIbfdname\fR\fR"
 279
 280 .IX Item "\f(CW--target=\fIbfdname\fR\fR"
 281
 282 .IX Item "\f(CW-C\fR"
 283
 284 .IX Item "\f(CW--demangle[=\fIstyle\fR]\fR"
 285
 286 .IX Item "\f(CW-e \fIfilename\fR\fR"
 287
 288 .IX Item "\f(CW--exe=\fIfilename\fR\fR"
 289
 290 .IX Item "\f(CW-f\fR"
 291
 292 .IX Item "\f(CW--functions\fR"
 293
 294 .IX Item "\f(CW-s\fR"
 295
 296 .IX Item "\f(CW--basenames\fR"
 297
 298 .IX Header "SEE ALSO"
 299
 300 .IX Header "COPYRIGHT"
 301