binutils/readelf.1

   1 .rn '' }`
   2 ''' $RCSfile$$Revision$$Date$
   3 '''
   4 ''' $Log$
   5 ''' Revision 1.1  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 READELF.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 readelf \- Displays information about ELF files.
 194 .SH "SYNOPSIS"
 195 readelf [ \-a | --all ]
 196         [ \-h | --file-header]
 197         [ \-l | --program-headers | --segments]
 198         [ \-S | --section-headers | --sections]
 199         [ \-e | --headers]
 200         [ \-s | --syms | --symbols]
 201         [ \-n | --notes]
 202         [ \-r | --relocs]
 203         [ \-u | --unwind]
 204         [ \-d | --dynamic]
 205         [ \-V | --version-info]
 206         [ \-D | --use-dynamic]
 207         [ \-x <number> | --hex-dump=<number>]
 208         [ \-w[liaprf] | --debug-dump[=info,=line,=abbrev,=pubnames,=ranges,=frames]]
 209         [      --histogram]
 210         [ \-v | --version]
 211         [ \-H | --help]
 212         \fIelffile\fR...
 213 .SH "DESCRIPTION"
 214 \f(CWreadelf\fR displays information about one or more ELF format object
 215 files.  The options control what particular information to display.
 216 .PP
 217 \fIelffile\fR... are the object files to be examined.  At the
 218 moment, \f(CWreadelf\fR does not support examining archives, nor does it
 219 support examing 64 bit ELF files.
 220 .SH "OPTIONS"
 221 The long and short forms of options, shown here as alternatives, are
 222 equivalent.  At least one option besides \fB\-v\fR or \fB\-H\fR must be
 223 given.
 224 .Ip "\f(CW-a\fR" 4
 225 .Ip "\f(CW--all\fR" 4
 226 Equivalent to specifiying \fB--file-header\fR,
 227 \fB--program-headers\fR, \fB--sections\fR, \fB--symbols\fR,
 228 \fB--relocs\fR, \fB--dynamic\fR, \fB--notes\fR and
 229 \fB--version-info\fR.
 230 .Ip "\f(CW-h\fR" 4
 231 .Ip "\f(CW--file-header\fR" 4
 232 Displays the information contained in the \s-1ELF\s0 header at the start of the
 233 file.
 234 .Ip "\f(CW-l\fR" 4
 235 .Ip "\f(CW--program-headers\fR" 4
 236 .Ip "\f(CW--segments\fR" 4
 237 Displays the information contained in the file's segment headers, if it
 238 has any.
 239 .Ip "\f(CW-S\fR" 4
 240 .Ip "\f(CW--sections\fR" 4
 241 .Ip "\f(CW--section-headers\fR" 4
 242 Displays the information contained in the file's section headers, if it
 243 has any.
 244 .Ip "\f(CW-s\fR" 4
 245 .Ip "\f(CW--symbols\fR" 4
 246 .Ip "\f(CW--syms\fR" 4
 247 Displays the entries in symbol table section of the file, if it has one.
 248 .Ip "\f(CW-e\fR" 4
 249 .Ip "\f(CW--headers\fR" 4
 250 Display all the headers in the file.  Equivalent to \fB\-h \-l \-S\fR.
 251 .Ip "\f(CW-n\fR" 4
 252 .Ip "\f(CW--notes\fR" 4
 253 Displays the contents of the \s-1NOTE\s0 segment, if it exists.
 254 .Ip "\f(CW-r\fR" 4
 255 .Ip "\f(CW--relocs\fR" 4
 256 Displays the contents of the file's relocation section, if it has one.
 257 .Ip "\f(CW-u\fR" 4
 258 .Ip "\f(CW--unwind\fR" 4
 259 Displays the contents of the file's unwind section, if it has one.  Only
 260 the unwind sections for \s-1IA64\s0 \s-1ELF\s0 files are currently supported.
 261 .Ip "\f(CW-d\fR" 4
 262 .Ip "\f(CW--dynamic\fR" 4
 263 Displays the contents of the file's dynamic section, if it has one.
 264 .Ip "\f(CW-V\fR" 4
 265 .Ip "\f(CW--version-info\fR" 4
 266 Displays the contents of the version sections in the file, it they
 267 exist.
 268 .Ip "\f(CW-D\fR" 4
 269 .Ip "\f(CW--use-dynamic\fR" 4
 270 When displaying symbols, this option makes \f(CWreadelf\fR use the
 271 symbol table in the file's dynamic section, rather than the one in the
 272 symbols section.
 273 .Ip "\f(CW-x <number>\fR" 4
 274 .Ip "\f(CW--hex-dump=<number>\fR" 4
 275 Displays the contents of the indicated section as a hexadecimal dump.
 276 .Ip "\f(CW-w[liaprf]\fR" 4
 277 .Ip "\f(CW--debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=frames]\fR" 4
 278 Displays the contents of the debug sections in the file, if any are
 279 present.  If one of the optional letters or words follows the switch
 280 then only data found in those specific sections will be dumped.
 281 .Ip "\f(CW--histogram\fR" 4
 282 Display a histogram of bucket list lengths when displaying the contents
 283 of the symbol tables.
 284 .Ip "\f(CW-v\fR" 4
 285 .Ip "\f(CW--version\fR" 4
 286 Display the version number of readelf.
 287 .Ip "\f(CW-H\fR" 4
 288 .Ip "\f(CW--help\fR" 4
 289 Display the command line options understood by \f(CWreadelf\fR.
 290 .SH "SEE ALSO"
 291 \fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
 292 .SH "COPYRIGHT"
 293 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 294 .PP
 295 Permission is granted to copy, distribute and/or modify this document
 296 under the terms of the GNU Free Documentation License, Version 1.1
 297 or any later version published by the Free Software Foundation;
 298 with no Invariant Sections, with no Front-Cover Texts, and with no
 299 Back-Cover Texts.  A copy of the license is included in the
 300 section entitled \*(L"GNU Free Documentation License\*(R".
 301
 302 .rn }` ''
 303 .IX Title "READELF.1 1"
 304 .IX Name "readelf - Displays information about ELF files."
 305
 306 .IX Header "NAME"
 307
 308 .IX Header "SYNOPSIS"
 309
 310 .IX Header "DESCRIPTION"
 311
 312 .IX Header "OPTIONS"
 313
 314 .IX Item "\f(CW-a\fR"
 315
 316 .IX Item "\f(CW--all\fR"
 317
 318 .IX Item "\f(CW-h\fR"
 319
 320 .IX Item "\f(CW--file-header\fR"
 321
 322 .IX Item "\f(CW-l\fR"
 323
 324 .IX Item "\f(CW--program-headers\fR"
 325
 326 .IX Item "\f(CW--segments\fR"
 327
 328 .IX Item "\f(CW-S\fR"
 329
 330 .IX Item "\f(CW--sections\fR"
 331
 332 .IX Item "\f(CW--section-headers\fR"
 333
 334 .IX Item "\f(CW-s\fR"
 335
 336 .IX Item "\f(CW--symbols\fR"
 337
 338 .IX Item "\f(CW--syms\fR"
 339
 340 .IX Item "\f(CW-e\fR"
 341
 342 .IX Item "\f(CW--headers\fR"
 343
 344 .IX Item "\f(CW-n\fR"
 345
 346 .IX Item "\f(CW--notes\fR"
 347
 348 .IX Item "\f(CW-r\fR"
 349
 350 .IX Item "\f(CW--relocs\fR"
 351
 352 .IX Item "\f(CW-u\fR"
 353
 354 .IX Item "\f(CW--unwind\fR"
 355
 356 .IX Item "\f(CW-d\fR"
 357
 358 .IX Item "\f(CW--dynamic\fR"
 359
 360 .IX Item "\f(CW-V\fR"
 361
 362 .IX Item "\f(CW--version-info\fR"
 363
 364 .IX Item "\f(CW-D\fR"
 365
 366 .IX Item "\f(CW--use-dynamic\fR"
 367
 368 .IX Item "\f(CW-x <number>\fR"
 369
 370 .IX Item "\f(CW--hex-dump=<number>\fR"
 371
 372 .IX Item "\f(CW-w[liaprf]\fR"
 373
 374 .IX Item "\f(CW--debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=frames]\fR"
 375
 376 .IX Item "\f(CW--histogram\fR"
 377
 378 .IX Item "\f(CW-v\fR"
 379
 380 .IX Item "\f(CW--version\fR"
 381
 382 .IX Item "\f(CW-H\fR"
 383
 384 .IX Item "\f(CW--help\fR"
 385
 386 .IX Header "SEE ALSO"
 387
 388 .IX Header "COPYRIGHT"
 389