contrib/binutils-2.21/binutils/doc/objdump.1

   1 .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sp \" Vertical space (when we can't use .PP)
   6 .if t .sp .5v
   7 .if n .sp
   8 ..
   9 .de Vb \" Begin verbatim text
  10 .ft CW
  11 .nf
  12 .ne \\$1
  13 ..
  14 .de Ve \" End verbatim text
  15 .ft R
  16 .fi
  17 ..
  18 .\" Set up some character translations and predefined strings.  \*(-- will
  19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  23 .\" nothing in troff, for use with C<>.
  24 .tr \(*W-
  25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26 .ie n \{\
  27 .    ds -- \(*W-
  28 .    ds PI pi
  29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  31 .    ds L" ""
  32 .    ds R" ""
  33 .    ds C` ""
  34 .    ds C' ""
  35 'br\}
  36 .el\{\
  37 .    ds -- \|\(em\|
  38 .    ds PI \(*p
  39 .    ds L" ``
  40 .    ds R" ''
  41 'br\}
  42 .\"
  43 .\" Escape single quotes in literal strings from groff's Unicode transform.
  44 .ie \n(.g .ds Aq \(aq
  45 .el       .ds Aq '
  46 .\"
  47 .\" If the F register is turned on, we'll generate index entries on stderr for
  48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  49 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  50 .\" output yourself in some meaningful fashion.
  51 .ie \nF \{\
  52 .    de IX
  53 .    tm Index:\\$1\t\\n%\t"\\$2"
  54 ..
  55 .    nr % 0
  56 .    rr F
  57 .\}
  58 .el \{\
  59 .    de IX
  60 ..
  61 .\}
  62 .\"
  63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  64 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  65 .    \" fudge factors for nroff and troff
  66 .if n \{\
  67 .    ds #H 0
  68 .    ds #V .8m
  69 .    ds #F .3m
  70 .    ds #[ \f1
  71 .    ds #] \fP
  72 .\}
  73 .if t \{\
  74 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  75 .    ds #V .6m
  76 .    ds #F 0
  77 .    ds #[ \&
  78 .    ds #] \&
  79 .\}
  80 .    \" simple accents for nroff and troff
  81 .if n \{\
  82 .    ds ' \&
  83 .    ds ` \&
  84 .    ds ^ \&
  85 .    ds , \&
  86 .    ds ~ ~
  87 .    ds /
  88 .\}
  89 .if t \{\
  90 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  91 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  92 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  93 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  94 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  95 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  96 .\}
  97 .    \" troff and (daisy-wheel) nroff accents
  98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
  99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 105 .ds ae a\h'-(\w'a'u*4/10)'e
 106 .ds Ae A\h'-(\w'A'u*4/10)'E
 107 .    \" corrections for vroff
 108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 110 .    \" for low resolution devices (crt and lpr)
 111 .if \n(.H>23 .if \n(.V>19 \
 112 \{\
 113 .    ds : e
 114 .    ds 8 ss
 115 .    ds o a
 116 .    ds d- d\h'-1'\(ga
 117 .    ds D- D\h'-1'\(hy
 118 .    ds th \o'bp'
 119 .    ds Th \o'LP'
 120 .    ds ae ae
 121 .    ds Ae AE
 122 .\}
 123 .rm #[ #] #H #V #F C
 124 .\" ========================================================================
 125 .\"
 126 .IX Title "OBJDUMP 1"
 127 .TH OBJDUMP 1 "2011-03-14" "binutils-2.21.0" "GNU Development Tools"
 128 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 129 .\" way too many mistakes in technical documents.
 130 .if n .ad l
 131 .nh
 132 .SH "NAME"
 133 objdump \- display information from object files.
 134 .SH "SYNOPSIS"
 135 .IX Header "SYNOPSIS"
 136 objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
 137         [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
 138         [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR] ]
 139         [\fB\-d\fR|\fB\-\-disassemble\fR]
 140         [\fB\-D\fR|\fB\-\-disassemble\-all\fR]
 141         [\fB\-z\fR|\fB\-\-disassemble\-zeroes\fR]
 142         [\fB\-EB\fR|\fB\-EL\fR|\fB\-\-endian=\fR{big | little }]
 143         [\fB\-f\fR|\fB\-\-file\-headers\fR]
 144         [\fB\-F\fR|\fB\-\-file\-offsets\fR]
 145         [\fB\-\-file\-start\-context\fR]
 146         [\fB\-g\fR|\fB\-\-debugging\fR]
 147         [\fB\-e\fR|\fB\-\-debugging\-tags\fR]
 148         [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR]
 149         [\fB\-i\fR|\fB\-\-info\fR]
 150         [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR]
 151         [\fB\-l\fR|\fB\-\-line\-numbers\fR]
 152         [\fB\-S\fR|\fB\-\-source\fR]
 153         [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR]
 154         [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR]
 155         [\fB\-p\fR|\fB\-\-private\-headers\fR]
 156         [\fB\-r\fR|\fB\-\-reloc\fR]
 157         [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
 158         [\fB\-s\fR|\fB\-\-full\-contents\fR]
 159         [\fB\-W[lLiaprmfFsoRt]\fR|
 160          \fB\-\-dwarf\fR[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]]
 161         [\fB\-G\fR|\fB\-\-stabs\fR]
 162         [\fB\-t\fR|\fB\-\-syms\fR]
 163         [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
 164         [\fB\-x\fR|\fB\-\-all\-headers\fR]
 165         [\fB\-w\fR|\fB\-\-wide\fR]
 166         [\fB\-\-start\-address=\fR\fIaddress\fR]
 167         [\fB\-\-stop\-address=\fR\fIaddress\fR]
 168         [\fB\-\-prefix\-addresses\fR]
 169         [\fB\-\-[no\-]show\-raw\-insn\fR]
 170         [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
 171         [\fB\-\-special\-syms\fR]
 172         [\fB\-\-prefix=\fR\fIprefix\fR]
 173         [\fB\-\-prefix\-strip=\fR\fIlevel\fR]
 174         [\fB\-\-insn\-width=\fR\fIwidth\fR]
 175         [\fB\-V\fR|\fB\-\-version\fR]
 176         [\fB\-H\fR|\fB\-\-help\fR]
 177         \fIobjfile\fR...
 178 .SH "DESCRIPTION"
 179 .IX Header "DESCRIPTION"
 180 \&\fBobjdump\fR displays information about one or more object files.
 181 The options control what particular information to display.  This
 182 information is mostly useful to programmers who are working on the
 183 compilation tools, as opposed to programmers who just want their
 184 program to compile and work.
 185 .PP
 186 \&\fIobjfile\fR... are the object files to be examined.  When you
 187 specify archives, \fBobjdump\fR shows information on each of the member
 188 object files.
 189 .SH "OPTIONS"
 190 .IX Header "OPTIONS"
 191 The long and short forms of options, shown here as alternatives, are
 192 equivalent.  At least one option from the list
 193 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
 194 .IP "\fB\-a\fR" 4
 195 .IX Item "-a"
 196 .PD 0
 197 .IP "\fB\-\-archive\-header\fR" 4
 198 .IX Item "--archive-header"
 199 .PD
 200 If any of the \fIobjfile\fR files are archives, display the archive
 201 header information (in a format similar to \fBls \-l\fR).  Besides the
 202 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
 203 the object file format of each archive member.
 204 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
 205 .IX Item "--adjust-vma=offset"
 206 When dumping information, first add \fIoffset\fR to all the section
 207 addresses.  This is useful if the section addresses do not correspond to
 208 the symbol table, which can happen when putting sections at particular
 209 addresses when using a format which can not represent section addresses,
 210 such as a.out.
 211 .IP "\fB\-b\fR \fIbfdname\fR" 4
 212 .IX Item "-b bfdname"
 213 .PD 0
 214 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
 215 .IX Item "--target=bfdname"
 216 .PD
 217 Specify that the object-code format for the object files is
 218 \&\fIbfdname\fR.  This option may not be necessary; \fIobjdump\fR can
 219 automatically recognize many formats.
 220 .Sp
 221 For example,
 222 .Sp
 223 .Vb 1
 224 \&        objdump \-b oasys \-m vax \-h fu.o
 225 .Ve
 226 .Sp
 227 displays summary information from the section headers (\fB\-h\fR) of
 228 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
 229 file in the format produced by Oasys compilers.  You can list the
 230 formats available with the \fB\-i\fR option.
 231 .IP "\fB\-C\fR" 4
 232 .IX Item "-C"
 233 .PD 0
 234 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
 235 .IX Item "--demangle[=style]"
 236 .PD
 237 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
 238 Besides removing any initial underscore prepended by the system, this
 239 makes \*(C+ function names readable.  Different compilers have different
 240 mangling styles. The optional demangling style argument can be used to
 241 choose an appropriate demangling style for your compiler.
 242 .IP "\fB\-g\fR" 4
 243 .IX Item "-g"
 244 .PD 0
 245 .IP "\fB\-\-debugging\fR" 4
 246 .IX Item "--debugging"
 247 .PD
 248 Display debugging information.  This attempts to parse \s-1STABS\s0 and \s-1IEEE\s0
 249 debugging format information stored in the file and print it out using
 250 a C like syntax.  If neither of these formats are found this option
 251 falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
 252 the file.
 253 .IP "\fB\-e\fR" 4
 254 .IX Item "-e"
 255 .PD 0
 256 .IP "\fB\-\-debugging\-tags\fR" 4
 257 .IX Item "--debugging-tags"
 258 .PD
 259 Like \fB\-g\fR, but the information is generated in a format compatible
 260 with ctags tool.
 261 .IP "\fB\-d\fR" 4
 262 .IX Item "-d"
 263 .PD 0
 264 .IP "\fB\-\-disassemble\fR" 4
 265 .IX Item "--disassemble"
 266 .PD
 267 Display the assembler mnemonics for the machine instructions from
 268 \&\fIobjfile\fR.  This option only disassembles those sections which are
 269 expected to contain instructions.
 270 .IP "\fB\-D\fR" 4
 271 .IX Item "-D"
 272 .PD 0
 273 .IP "\fB\-\-disassemble\-all\fR" 4
 274 .IX Item "--disassemble-all"
 275 .PD
 276 Like \fB\-d\fR, but disassemble the contents of all sections, not just
 277 those expected to contain instructions.
 278 .Sp
 279 If the target is an \s-1ARM\s0 architecture this switch also has the effect
 280 of forcing the disassembler to decode pieces of data found in code
 281 sections as if they were instructions.
 282 .IP "\fB\-\-prefix\-addresses\fR" 4
 283 .IX Item "--prefix-addresses"
 284 When disassembling, print the complete address on each line.  This is
 285 the older disassembly format.
 286 .IP "\fB\-EB\fR" 4
 287 .IX Item "-EB"
 288 .PD 0
 289 .IP "\fB\-EL\fR" 4
 290 .IX Item "-EL"
 291 .IP "\fB\-\-endian={big|little}\fR" 4
 292 .IX Item "--endian={big|little}"
 293 .PD
 294 Specify the endianness of the object files.  This only affects
 295 disassembly.  This can be useful when disassembling a file format which
 296 does not describe endianness information, such as S\-records.
 297 .IP "\fB\-f\fR" 4
 298 .IX Item "-f"
 299 .PD 0
 300 .IP "\fB\-\-file\-headers\fR" 4
 301 .IX Item "--file-headers"
 302 .PD
 303 Display summary information from the overall header of
 304 each of the \fIobjfile\fR files.
 305 .IP "\fB\-F\fR" 4
 306 .IX Item "-F"
 307 .PD 0
 308 .IP "\fB\-\-file\-offsets\fR" 4
 309 .IX Item "--file-offsets"
 310 .PD
 311 When disassembling sections, whenever a symbol is displayed, also
 312 display the file offset of the region of data that is about to be
 313 dumped.  If zeroes are being skipped, then when disassembly resumes,
 314 tell the user how many zeroes were skipped and the file offset of the
 315 location from where the disassembly resumes.  When dumping sections,
 316 display the file offset of the location from where the dump starts.
 317 .IP "\fB\-\-file\-start\-context\fR" 4
 318 .IX Item "--file-start-context"
 319 Specify that when displaying interlisted source code/disassembly
 320 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
 321 context to the start of the file.
 322 .IP "\fB\-h\fR" 4
 323 .IX Item "-h"
 324 .PD 0
 325 .IP "\fB\-\-section\-headers\fR" 4
 326 .IX Item "--section-headers"
 327 .IP "\fB\-\-headers\fR" 4
 328 .IX Item "--headers"
 329 .PD
 330 Display summary information from the section headers of the
 331 object file.
 332 .Sp
 333 File segments may be relocated to nonstandard addresses, for example by
 334 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
 335 \&\fBld\fR.  However, some object file formats, such as a.out, do not
 336 store the starting address of the file segments.  In those situations,
 337 although \fBld\fR relocates the sections correctly, using \fBobjdump
 338 \&\-h\fR to list the file section headers cannot show the correct addresses.
 339 Instead, it shows the usual addresses, which are implicit for the
 340 target.
 341 .IP "\fB\-H\fR" 4
 342 .IX Item "-H"
 343 .PD 0
 344 .IP "\fB\-\-help\fR" 4
 345 .IX Item "--help"
 346 .PD
 347 Print a summary of the options to \fBobjdump\fR and exit.
 348 .IP "\fB\-i\fR" 4
 349 .IX Item "-i"
 350 .PD 0
 351 .IP "\fB\-\-info\fR" 4
 352 .IX Item "--info"
 353 .PD
 354 Display a list showing all architectures and object formats available
 355 for specification with \fB\-b\fR or \fB\-m\fR.
 356 .IP "\fB\-j\fR \fIname\fR" 4
 357 .IX Item "-j name"
 358 .PD 0
 359 .IP "\fB\-\-section=\fR\fIname\fR" 4
 360 .IX Item "--section=name"
 361 .PD
 362 Display information only for section \fIname\fR.
 363 .IP "\fB\-l\fR" 4
 364 .IX Item "-l"
 365 .PD 0
 366 .IP "\fB\-\-line\-numbers\fR" 4
 367 .IX Item "--line-numbers"
 368 .PD
 369 Label the display (using debugging information) with the filename and
 370 source line numbers corresponding to the object code or relocs shown.
 371 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
 372 .IP "\fB\-m\fR \fImachine\fR" 4
 373 .IX Item "-m machine"
 374 .PD 0
 375 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
 376 .IX Item "--architecture=machine"
 377 .PD
 378 Specify the architecture to use when disassembling object files.  This
 379 can be useful when disassembling object files which do not describe
 380 architecture information, such as S\-records.  You can list the available
 381 architectures with the \fB\-i\fR option.
 382 .Sp
 383 If the target is an \s-1ARM\s0 architecture then this switch has an
 384 additional effect.  It restricts the disassembly to only those
 385 instructions supported by the architecture specified by \fImachine\fR.
 386 If it is necessary to use this switch because the input file does not
 387 contain any architecture information, but it is also desired to
 388 disassemble all the instructions use \fB\-marm\fR.
 389 .IP "\fB\-M\fR \fIoptions\fR" 4
 390 .IX Item "-M options"
 391 .PD 0
 392 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
 393 .IX Item "--disassembler-options=options"
 394 .PD
 395 Pass target specific information to the disassembler.  Only supported on
 396 some targets.  If it is necessary to specify more than one
 397 disassembler option then multiple \fB\-M\fR options can be used or
 398 can be placed together into a comma separated list.
 399 .Sp
 400 If the target is an \s-1ARM\s0 architecture then this switch can be used to
 401 select which register name set is used during disassembler.  Specifying
 402 \&\fB\-M reg-names-std\fR (the default) will select the register names as
 403 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
 404 \&'sp', register 14 called 'lr' and register 15 called 'pc'.  Specifying
 405 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
 406 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
 407 just use \fBr\fR followed by the register number.
 408 .Sp
 409 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
 410 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
 411 use the ARM/Thumb Procedure Call Standard naming conventions.  (Either
 412 with the normal register names or the special register names).
 413 .Sp
 414 This option can also be used for \s-1ARM\s0 architectures to force the
 415 disassembler to interpret all instructions as Thumb instructions by
 416 using the switch \fB\-\-disassembler\-options=force\-thumb\fR.  This can be
 417 useful when attempting to disassemble thumb code produced by other
 418 compilers.
 419 .Sp
 420 For the x86, some of the options duplicate functions of the \fB\-m\fR
 421 switch, but allow finer grained control.  Multiple selections from the
 422 following may be specified as a comma separated string.
 423 \&\fBx86\-64\fR, \fBi386\fR and \fBi8086\fR select disassembly for
 424 the given architecture.  \fBintel\fR and \fBatt\fR select between
 425 intel syntax mode and \s-1AT&T\s0 syntax mode.
 426 \&\fBintel-mnemonic\fR and \fBatt-mnemonic\fR select between
 427 intel mnemonic mode and \s-1AT&T\s0 mnemonic mode. \fBintel-mnemonic\fR
 428 implies \fBintel\fR and \fBatt-mnemonic\fR implies \fBatt\fR.
 429 \&\fBaddr64\fR, \fBaddr32\fR,
 430 \&\fBaddr16\fR, \fBdata32\fR and \fBdata16\fR specify the default
 431 address size and operand size.  These four options will be overridden if
 432 \&\fBx86\-64\fR, \fBi386\fR or \fBi8086\fR appear later in the
 433 option string.  Lastly, \fBsuffix\fR, when in \s-1AT&T\s0 mode,
 434 instructs the disassembler to print a mnemonic suffix even when the
 435 suffix could be inferred by the operands.
 436 .Sp
 437 For PowerPC, \fBbooke\fR controls the disassembly of BookE
 438 instructions.  \fB32\fR and \fB64\fR select PowerPC and
 439 PowerPC64 disassembly, respectively.  \fBe300\fR selects
 440 disassembly for the e300 family.  \fB440\fR selects disassembly for
 441 the PowerPC 440.  \fBppcps\fR selects disassembly for the paired
 442 single instructions of the \s-1PPC750CL\s0.
 443 .Sp
 444 For \s-1MIPS\s0, this option controls the printing of instruction mnemonic
 445 names and register names in disassembled instructions.  Multiple
 446 selections from the following may be specified as a comma separated
 447 string, and invalid options are ignored:
 448 .RS 4
 449 .ie n .IP """no\-aliases""" 4
 450 .el .IP "\f(CWno\-aliases\fR" 4
 451 .IX Item "no-aliases"
 452 Print the 'raw' instruction mnemonic instead of some pseudo
 453 instruction mnemonic.  I.e., print 'daddu' or 'or' instead of 'move',
 454 \&'sll' instead of 'nop', etc.
 455 .ie n .IP """gpr\-names=\f(CIABI\f(CW""" 4
 456 .el .IP "\f(CWgpr\-names=\f(CIABI\f(CW\fR" 4
 457 .IX Item "gpr-names=ABI"
 458 Print \s-1GPR\s0 (general-purpose register) names as appropriate
 459 for the specified \s-1ABI\s0.  By default, \s-1GPR\s0 names are selected according to
 460 the \s-1ABI\s0 of the binary being disassembled.
 461 .ie n .IP """fpr\-names=\f(CIABI\f(CW""" 4
 462 .el .IP "\f(CWfpr\-names=\f(CIABI\f(CW\fR" 4
 463 .IX Item "fpr-names=ABI"
 464 Print \s-1FPR\s0 (floating-point register) names as
 465 appropriate for the specified \s-1ABI\s0.  By default, \s-1FPR\s0 numbers are printed
 466 rather than names.
 467 .ie n .IP """cp0\-names=\f(CIARCH\f(CW""" 4
 468 .el .IP "\f(CWcp0\-names=\f(CIARCH\f(CW\fR" 4
 469 .IX Item "cp0-names=ARCH"
 470 Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names
 471 as appropriate for the \s-1CPU\s0 or architecture specified by
 472 \&\fI\s-1ARCH\s0\fR.  By default, \s-1CP0\s0 register names are selected according to
 473 the architecture and \s-1CPU\s0 of the binary being disassembled.
 474 .ie n .IP """hwr\-names=\f(CIARCH\f(CW""" 4
 475 .el .IP "\f(CWhwr\-names=\f(CIARCH\f(CW\fR" 4
 476 .IX Item "hwr-names=ARCH"
 477 Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
 478 as appropriate for the \s-1CPU\s0 or architecture specified by
 479 \&\fI\s-1ARCH\s0\fR.  By default, \s-1HWR\s0 names are selected according to
 480 the architecture and \s-1CPU\s0 of the binary being disassembled.
 481 .ie n .IP """reg\-names=\f(CIABI\f(CW""" 4
 482 .el .IP "\f(CWreg\-names=\f(CIABI\f(CW\fR" 4
 483 .IX Item "reg-names=ABI"
 484 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI\s0.
 485 .ie n .IP """reg\-names=\f(CIARCH\f(CW""" 4
 486 .el .IP "\f(CWreg\-names=\f(CIARCH\f(CW\fR" 4
 487 .IX Item "reg-names=ARCH"
 488 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
 489 as appropriate for the selected \s-1CPU\s0 or architecture.
 490 .RE
 491 .RS 4
 492 .Sp
 493 For any of the options listed above, \fI\s-1ABI\s0\fR or
 494 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
 495 rather than names, for the selected types of registers.
 496 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
 497 the \fB\-\-help\fR option.
 498 .Sp
 499 For \s-1VAX\s0, you can specify function entry addresses with \fB\-M
 500 entry:0xf00ba\fR.  You can use this multiple times to properly
 501 disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like
 502 \&\s-1ROM\s0 dumps).  In these cases, the function entry mask would otherwise
 503 be decoded as \s-1VAX\s0 instructions, which would probably lead the rest
 504 of the function being wrongly disassembled.
 505 .RE
 506 .IP "\fB\-p\fR" 4
 507 .IX Item "-p"
 508 .PD 0
 509 .IP "\fB\-\-private\-headers\fR" 4
 510 .IX Item "--private-headers"
 511 .PD
 512 Print information that is specific to the object file format.  The exact
 513 information printed depends upon the object file format.  For some
 514 object file formats, no additional information is printed.
 515 .IP "\fB\-r\fR" 4
 516 .IX Item "-r"
 517 .PD 0
 518 .IP "\fB\-\-reloc\fR" 4
 519 .IX Item "--reloc"
 520 .PD
 521 Print the relocation entries of the file.  If used with \fB\-d\fR or
 522 \&\fB\-D\fR, the relocations are printed interspersed with the
 523 disassembly.
 524 .IP "\fB\-R\fR" 4
 525 .IX Item "-R"
 526 .PD 0
 527 .IP "\fB\-\-dynamic\-reloc\fR" 4
 528 .IX Item "--dynamic-reloc"
 529 .PD
 530 Print the dynamic relocation entries of the file.  This is only
 531 meaningful for dynamic objects, such as certain types of shared
 532 libraries.  As for \fB\-r\fR, if used with \fB\-d\fR or
 533 \&\fB\-D\fR, the relocations are printed interspersed with the
 534 disassembly.
 535 .IP "\fB\-s\fR" 4
 536 .IX Item "-s"
 537 .PD 0
 538 .IP "\fB\-\-full\-contents\fR" 4
 539 .IX Item "--full-contents"
 540 .PD
 541 Display the full contents of any sections requested.  By default all
 542 non-empty sections are displayed.
 543 .IP "\fB\-S\fR" 4
 544 .IX Item "-S"
 545 .PD 0
 546 .IP "\fB\-\-source\fR" 4
 547 .IX Item "--source"
 548 .PD
 549 Display source code intermixed with disassembly, if possible.  Implies
 550 \&\fB\-d\fR.
 551 .IP "\fB\-\-prefix=\fR\fIprefix\fR" 4
 552 .IX Item "--prefix=prefix"
 553 Specify \fIprefix\fR to add to the absolute paths when used with
 554 \&\fB\-S\fR.
 555 .IP "\fB\-\-prefix\-strip=\fR\fIlevel\fR" 4
 556 .IX Item "--prefix-strip=level"
 557 Indicate how many initial directory names to strip off the hardwired
 558 absolute paths. It has no effect without \fB\-\-prefix=\fR\fIprefix\fR.
 559 .IP "\fB\-\-show\-raw\-insn\fR" 4
 560 .IX Item "--show-raw-insn"
 561 When disassembling instructions, print the instruction in hex as well as
 562 in symbolic form.  This is the default except when
 563 \&\fB\-\-prefix\-addresses\fR is used.
 564 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
 565 .IX Item "--no-show-raw-insn"
 566 When disassembling instructions, do not print the instruction bytes.
 567 This is the default when \fB\-\-prefix\-addresses\fR is used.
 568 .IP "\fB\-\-insn\-width=\fR\fIwidth\fR" 4
 569 .IX Item "--insn-width=width"
 570 Display \fIwidth\fR bytes on a single line when disassembling
 571 instructions.
 572 .IP "\fB\-W[lLiaprmfFsoRt]\fR" 4
 573 .IX Item "-W[lLiaprmfFsoRt]"
 574 .PD 0
 575 .IP "\fB\-\-dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]\fR" 4
 576 .IX Item "--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]"
 577 .PD
 578 Displays the contents of the debug sections in the file, if any are
 579 present.  If one of the optional letters or words follows the switch
 580 then only data found in those specific sections will be dumped.
 581 .Sp
 582 Note that there is no single letter option to display the content of
 583 trace sections or .gdb_index.
 584 .IP "\fB\-G\fR" 4
 585 .IX Item "-G"
 586 .PD 0
 587 .IP "\fB\-\-stabs\fR" 4
 588 .IX Item "--stabs"
 589 .PD
 590 Display the full contents of any sections requested.  Display the
 591 contents of the .stab and .stab.index and .stab.excl sections from an
 592 \&\s-1ELF\s0 file.  This is only useful on systems (such as Solaris 2.0) in which
 593 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
 594 section.  In most other file formats, debugging symbol-table entries are
 595 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
 596 output.
 597 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
 598 .IX Item "--start-address=address"
 599 Start displaying data at the specified address.  This affects the output
 600 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
 601 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
 602 .IX Item "--stop-address=address"
 603 Stop displaying data at the specified address.  This affects the output
 604 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
 605 .IP "\fB\-t\fR" 4
 606 .IX Item "-t"
 607 .PD 0
 608 .IP "\fB\-\-syms\fR" 4
 609 .IX Item "--syms"
 610 .PD
 611 Print the symbol table entries of the file.
 612 This is similar to the information provided by the \fBnm\fR program,
 613 although the display format is different.  The format of the output
 614 depends upon the format of the file being dumped, but there are two main
 615 types.  One looks like this:
 616 .Sp
 617 .Vb 2
 618 \&        [  4](sec  3)(fl 0x00)(ty   0)(scl   3) (nx 1) 0x00000000 .bss
 619 \&        [  6](sec  1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x00000000 fred
 620 .Ve
 621 .Sp
 622 where the number inside the square brackets is the number of the entry
 623 in the symbol table, the \fIsec\fR number is the section number, the
 624 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
 625 symbol's type, the \fIscl\fR number is the symbol's storage class and
 626 the \fInx\fR value is the number of auxilary entries associated with
 627 the symbol.  The last two fields are the symbol's value and its name.
 628 .Sp
 629 The other common output format, usually seen with \s-1ELF\s0 based files,
 630 looks like this:
 631 .Sp
 632 .Vb 2
 633 \&        00000000 l    d  .bss   00000000 .bss
 634 \&        00000000 g       .text  00000000 fred
 635 .Ve
 636 .Sp
 637 Here the first number is the symbol's value (sometimes refered to as
 638 its address).  The next field is actually a set of characters and
 639 spaces indicating the flag bits that are set on the symbol.  These
 640 characters are described below.  Next is the section with which the
 641 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
 642 not connected with any section), or \fI*UND*\fR if the section is
 643 referenced in the file being dumped, but not defined there.
 644 .Sp
 645 After the section name comes another field, a number, which for common
 646 symbols is the alignment and for other symbol is the size.  Finally
 647 the symbol's name is displayed.
 648 .Sp
 649 The flag characters are divided into 7 groups as follows:
 650 .RS 4
 651 .ie n .IP """l""" 4
 652 .el .IP "\f(CWl\fR" 4
 653 .IX Item "l"
 654 .PD 0
 655 .ie n .IP """g""" 4
 656 .el .IP "\f(CWg\fR" 4
 657 .IX Item "g"
 658 .ie n .IP """u""" 4
 659 .el .IP "\f(CWu\fR" 4
 660 .IX Item "u"
 661 .ie n .IP """!""" 4
 662 .el .IP "\f(CW!\fR" 4
 663 .IX Item "!"
 664 .PD
 665 The symbol is a local (l), global (g), unique global (u), neither
 666 global nor local (a space) or both global and local (!).  A
 667 symbol can be neither local or global for a variety of reasons, e.g.,
 668 because it is used for debugging, but it is probably an indication of
 669 a bug if it is ever both local and global.  Unique global symbols are
 670 a \s-1GNU\s0 extension to the standard set of \s-1ELF\s0 symbol bindings.  For such
 671 a symbol the dynamic linker will make sure that in the entire process
 672 there is just one symbol with this name and type in use.
 673 .ie n .IP """w""" 4
 674 .el .IP "\f(CWw\fR" 4
 675 .IX Item "w"
 676 The symbol is weak (w) or strong (a space).
 677 .ie n .IP """C""" 4
 678 .el .IP "\f(CWC\fR" 4
 679 .IX Item "C"
 680 The symbol denotes a constructor (C) or an ordinary symbol (a space).
 681 .ie n .IP """W""" 4
 682 .el .IP "\f(CWW\fR" 4
 683 .IX Item "W"
 684 The symbol is a warning (W) or a normal symbol (a space).  A warning
 685 symbol's name is a message to be displayed if the symbol following the
 686 warning symbol is ever referenced.
 687 .ie n .IP """I""" 4
 688 .el .IP "\f(CWI\fR" 4
 689 .IX Item "I"
 690 .PD 0
 691 .ie n .IP """i""" 4
 692 .el .IP "\f(CWi\fR" 4
 693 .IX Item "i"
 694 .PD
 695 The symbol is an indirect reference to another symbol (I), a function
 696 to be evaluated during reloc processing (i) or a normal symbol (a
 697 space).
 698 .ie n .IP """d""" 4
 699 .el .IP "\f(CWd\fR" 4
 700 .IX Item "d"
 701 .PD 0
 702 .ie n .IP """D""" 4
 703 .el .IP "\f(CWD\fR" 4
 704 .IX Item "D"
 705 .PD
 706 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
 707 normal symbol (a space).
 708 .ie n .IP """F""" 4
 709 .el .IP "\f(CWF\fR" 4
 710 .IX Item "F"
 711 .PD 0
 712 .ie n .IP """f""" 4
 713 .el .IP "\f(CWf\fR" 4
 714 .IX Item "f"
 715 .ie n .IP """O""" 4
 716 .el .IP "\f(CWO\fR" 4
 717 .IX Item "O"
 718 .PD
 719 The symbol is the name of a function (F) or a file (f) or an object
 720 (O) or just a normal symbol (a space).
 721 .RE
 722 .RS 4
 723 .RE
 724 .IP "\fB\-T\fR" 4
 725 .IX Item "-T"
 726 .PD 0
 727 .IP "\fB\-\-dynamic\-syms\fR" 4
 728 .IX Item "--dynamic-syms"
 729 .PD
 730 Print the dynamic symbol table entries of the file.  This is only
 731 meaningful for dynamic objects, such as certain types of shared
 732 libraries.  This is similar to the information provided by the \fBnm\fR
 733 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
 734 .IP "\fB\-\-special\-syms\fR" 4
 735 .IX Item "--special-syms"
 736 When displaying symbols include those which the target considers to be
 737 special in some way and which would not normally be of interest to the
 738 user.
 739 .IP "\fB\-V\fR" 4
 740 .IX Item "-V"
 741 .PD 0
 742 .IP "\fB\-\-version\fR" 4
 743 .IX Item "--version"
 744 .PD
 745 Print the version number of \fBobjdump\fR and exit.
 746 .IP "\fB\-x\fR" 4
 747 .IX Item "-x"
 748 .PD 0
 749 .IP "\fB\-\-all\-headers\fR" 4
 750 .IX Item "--all-headers"
 751 .PD
 752 Display all available header information, including the symbol table and
 753 relocation entries.  Using \fB\-x\fR is equivalent to specifying all of
 754 \&\fB\-a \-f \-h \-p \-r \-t\fR.
 755 .IP "\fB\-w\fR" 4
 756 .IX Item "-w"
 757 .PD 0
 758 .IP "\fB\-\-wide\fR" 4
 759 .IX Item "--wide"
 760 .PD
 761 Format some lines for output devices that have more than 80 columns.
 762 Also do not truncate symbol names when they are displayed.
 763 .IP "\fB\-z\fR" 4
 764 .IX Item "-z"
 765 .PD 0
 766 .IP "\fB\-\-disassemble\-zeroes\fR" 4
 767 .IX Item "--disassemble-zeroes"
 768 .PD
 769 Normally the disassembly output will skip blocks of zeroes.  This
 770 option directs the disassembler to disassemble those blocks, just like
 771 any other data.
 772 .IP "\fB@\fR\fIfile\fR" 4
 773 .IX Item "@file"
 774 Read command-line options from \fIfile\fR.  The options read are
 775 inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
 776 does not exist, or cannot be read, then the option will be treated
 777 literally, and not removed.
 778 .Sp
 779 Options in \fIfile\fR are separated by whitespace.  A whitespace
 780 character may be included in an option by surrounding the entire
 781 option in either single or double quotes.  Any character (including a
 782 backslash) may be included by prefixing the character to be included
 783 with a backslash.  The \fIfile\fR may itself contain additional
 784 @\fIfile\fR options; any such options will be processed recursively.
 785 .SH "SEE ALSO"
 786 .IX Header "SEE ALSO"
 787 \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
 788 .SH "COPYRIGHT"
 789 .IX Header "COPYRIGHT"
 790 Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
 791 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
 792 Free Software Foundation, Inc.
 793 .PP
 794 Permission is granted to copy, distribute and/or modify this document
 795 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
 796 or any later version published by the Free Software Foundation;
 797 with no Invariant Sections, with no Front-Cover Texts, and with no
 798 Back-Cover Texts.  A copy of the license is included in the
 799 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".