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

   1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sh \" Subsection heading
   6 .br
   7 .if t .Sp
   8 .ne 5
   9 .PP
  10 \fB\\$1\fR
  11 .PP
  12 ..
  13 .de Sp \" Vertical space (when we can't use .PP)
  14 .if t .sp .5v
  15 .if n .sp
  16 ..
  17 .de Vb \" Begin verbatim text
  18 .ft CW
  19 .nf
  20 .ne \\$1
  21 ..
  22 .de Ve \" End verbatim text
  23 .ft R
  24 .fi
  25 ..
  26 .\" Set up some character translations and predefined strings.  \*(-- will
  27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  28 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  29 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  30 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  31 .\" nothing in troff, for use with C<>.
  32 .tr \(*W-
  33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  34 .ie n \{\
  35 .    ds -- \(*W-
  36 .    ds PI pi
  37 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  38 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  39 .    ds L" ""
  40 .    ds R" ""
  41 .    ds C` ""
  42 .    ds C' ""
  43 'br\}
  44 .el\{\
  45 .    ds -- \|\(em\|
  46 .    ds PI \(*p
  47 .    ds L" ``
  48 .    ds R" ''
  49 'br\}
  50 .\"
  51 .\" If the F register is turned on, we'll generate index entries on stderr for
  52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  54 .\" output yourself in some meaningful fashion.
  55 .if \nF \{\
  56 .    de IX
  57 .    tm Index:\\$1\t\\n%\t"\\$2"
  58 ..
  59 .    nr % 0
  60 .    rr F
  61 .\}
  62 .\"
  63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
  64 .\" way too many mistakes in technical documents.
  65 .hy 0
  66 .\"
  67 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  68 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  69 .    \" fudge factors for nroff and troff
  70 .if n \{\
  71 .    ds #H 0
  72 .    ds #V .8m
  73 .    ds #F .3m
  74 .    ds #[ \f1
  75 .    ds #] \fP
  76 .\}
  77 .if t \{\
  78 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  79 .    ds #V .6m
  80 .    ds #F 0
  81 .    ds #[ \&
  82 .    ds #] \&
  83 .\}
  84 .    \" simple accents for nroff and troff
  85 .if n \{\
  86 .    ds ' \&
  87 .    ds ` \&
  88 .    ds ^ \&
  89 .    ds , \&
  90 .    ds ~ ~
  91 .    ds /
  92 .\}
  93 .if t \{\
  94 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  95 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  96 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  97 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  98 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  99 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 100 .\}
 101 .    \" troff and (daisy-wheel) nroff accents
 102 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 103 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 104 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 105 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 106 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 107 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 108 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 109 .ds ae a\h'-(\w'a'u*4/10)'e
 110 .ds Ae A\h'-(\w'A'u*4/10)'E
 111 .    \" corrections for vroff
 112 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 113 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 114 .    \" for low resolution devices (crt and lpr)
 115 .if \n(.H>23 .if \n(.V>19 \
 116 \{\
 117 .    ds : e
 118 .    ds 8 ss
 119 .    ds o a
 120 .    ds d- d\h'-1'\(ga
 121 .    ds D- D\h'-1'\(hy
 122 .    ds th \o'bp'
 123 .    ds Th \o'LP'
 124 .    ds ae ae
 125 .    ds Ae AE
 126 .\}
 127 .rm #[ #] #H #V #F C
 128 .\" ========================================================================
 129 .\"
 130 .IX Title "OBJDUMP 1"
 131 .TH OBJDUMP 1 "2006-06-23" "binutils-2.17" "GNU Development Tools"
 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\-\-file\-start\-context\fR]
 145         [\fB\-g\fR|\fB\-\-debugging\fR]
 146         [\fB\-e\fR|\fB\-\-debugging\-tags\fR]
 147         [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR]
 148         [\fB\-i\fR|\fB\-\-info\fR]
 149         [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR]
 150         [\fB\-l\fR|\fB\-\-line\-numbers\fR]
 151         [\fB\-S\fR|\fB\-\-source\fR]
 152         [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR]
 153         [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR]
 154         [\fB\-p\fR|\fB\-\-private\-headers\fR]
 155         [\fB\-r\fR|\fB\-\-reloc\fR]
 156         [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
 157         [\fB\-s\fR|\fB\-\-full\-contents\fR]
 158         [\fB\-W\fR|\fB\-\-dwarf\fR]
 159         [\fB\-G\fR|\fB\-\-stabs\fR]
 160         [\fB\-t\fR|\fB\-\-syms\fR]
 161         [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
 162         [\fB\-x\fR|\fB\-\-all\-headers\fR]
 163         [\fB\-w\fR|\fB\-\-wide\fR]
 164         [\fB\-\-start\-address=\fR\fIaddress\fR]
 165         [\fB\-\-stop\-address=\fR\fIaddress\fR]
 166         [\fB\-\-prefix\-addresses\fR]
 167         [\fB\-\-[no\-]show\-raw\-insn\fR]
 168         [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
 169         [\fB\-\-special\-syms\fR]
 170         [\fB\-V\fR|\fB\-\-version\fR]
 171         [\fB\-H\fR|\fB\-\-help\fR]
 172         \fIobjfile\fR...
 173 .SH "DESCRIPTION"
 174 .IX Header "DESCRIPTION"
 175 \&\fBobjdump\fR displays information about one or more object files.
 176 The options control what particular information to display.  This
 177 information is mostly useful to programmers who are working on the
 178 compilation tools, as opposed to programmers who just want their
 179 program to compile and work.
 180 .PP
 181 \&\fIobjfile\fR... are the object files to be examined.  When you
 182 specify archives, \fBobjdump\fR shows information on each of the member
 183 object files.
 184 .SH "OPTIONS"
 185 .IX Header "OPTIONS"
 186 The long and short forms of options, shown here as alternatives, are
 187 equivalent.  At least one option from the list
 188 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
 189 .IP "\fB\-a\fR" 4
 190 .IX Item "-a"
 191 .PD 0
 192 .IP "\fB\-\-archive\-header\fR" 4
 193 .IX Item "--archive-header"
 194 .PD
 195 If any of the \fIobjfile\fR files are archives, display the archive
 196 header information (in a format similar to \fBls \-l\fR).  Besides the
 197 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
 198 the object file format of each archive member.
 199 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
 200 .IX Item "--adjust-vma=offset"
 201 When dumping information, first add \fIoffset\fR to all the section
 202 addresses.  This is useful if the section addresses do not correspond to
 203 the symbol table, which can happen when putting sections at particular
 204 addresses when using a format which can not represent section addresses,
 205 such as a.out.
 206 .IP "\fB\-b\fR \fIbfdname\fR" 4
 207 .IX Item "-b bfdname"
 208 .PD 0
 209 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
 210 .IX Item "--target=bfdname"
 211 .PD
 212 Specify that the object-code format for the object files is
 213 \&\fIbfdname\fR.  This option may not be necessary; \fIobjdump\fR can
 214 automatically recognize many formats.
 215 .Sp
 216 For example,
 217 .Sp
 218 .Vb 1
 219 \&        objdump \-b oasys \-m vax \-h fu.o
 220 .Ve
 221 .Sp
 222 displays summary information from the section headers (\fB\-h\fR) of
 223 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
 224 file in the format produced by Oasys compilers.  You can list the
 225 formats available with the \fB\-i\fR option.
 226 .IP "\fB\-C\fR" 4
 227 .IX Item "-C"
 228 .PD 0
 229 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
 230 .IX Item "--demangle[=style]"
 231 .PD
 232 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
 233 Besides removing any initial underscore prepended by the system, this
 234 makes \*(C+ function names readable.  Different compilers have different
 235 mangling styles. The optional demangling style argument can be used to
 236 choose an appropriate demangling style for your compiler.
 237 .IP "\fB\-g\fR" 4
 238 .IX Item "-g"
 239 .PD 0
 240 .IP "\fB\-\-debugging\fR" 4
 241 .IX Item "--debugging"
 242 .PD
 243 Display debugging information.  This attempts to parse debugging
 244 information stored in the file and print it out using a C like syntax.
 245 Only certain types of debugging information have been implemented.
 246 Some other types are supported by \fBreadelf \-w\fR.
 247 .IP "\fB\-e\fR" 4
 248 .IX Item "-e"
 249 .PD 0
 250 .IP "\fB\-\-debugging\-tags\fR" 4
 251 .IX Item "--debugging-tags"
 252 .PD
 253 Like \fB\-g\fR, but the information is generated in a format compatible
 254 with ctags tool.
 255 .IP "\fB\-d\fR" 4
 256 .IX Item "-d"
 257 .PD 0
 258 .IP "\fB\-\-disassemble\fR" 4
 259 .IX Item "--disassemble"
 260 .PD
 261 Display the assembler mnemonics for the machine instructions from
 262 \&\fIobjfile\fR.  This option only disassembles those sections which are
 263 expected to contain instructions.
 264 .IP "\fB\-D\fR" 4
 265 .IX Item "-D"
 266 .PD 0
 267 .IP "\fB\-\-disassemble\-all\fR" 4
 268 .IX Item "--disassemble-all"
 269 .PD
 270 Like \fB\-d\fR, but disassemble the contents of all sections, not just
 271 those expected to contain instructions.
 272 .IP "\fB\-\-prefix\-addresses\fR" 4
 273 .IX Item "--prefix-addresses"
 274 When disassembling, print the complete address on each line.  This is
 275 the older disassembly format.
 276 .IP "\fB\-EB\fR" 4
 277 .IX Item "-EB"
 278 .PD 0
 279 .IP "\fB\-EL\fR" 4
 280 .IX Item "-EL"
 281 .IP "\fB\-\-endian={big|little}\fR" 4
 282 .IX Item "--endian={big|little}"
 283 .PD
 284 Specify the endianness of the object files.  This only affects
 285 disassembly.  This can be useful when disassembling a file format which
 286 does not describe endianness information, such as S\-records.
 287 .IP "\fB\-f\fR" 4
 288 .IX Item "-f"
 289 .PD 0
 290 .IP "\fB\-\-file\-headers\fR" 4
 291 .IX Item "--file-headers"
 292 .PD
 293 Display summary information from the overall header of
 294 each of the \fIobjfile\fR files.
 295 .IP "\fB\-\-file\-start\-context\fR" 4
 296 .IX Item "--file-start-context"
 297 Specify that when displaying interlisted source code/disassembly
 298 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
 299 context to the start of the file.
 300 .IP "\fB\-h\fR" 4
 301 .IX Item "-h"
 302 .PD 0
 303 .IP "\fB\-\-section\-headers\fR" 4
 304 .IX Item "--section-headers"
 305 .IP "\fB\-\-headers\fR" 4
 306 .IX Item "--headers"
 307 .PD
 308 Display summary information from the section headers of the
 309 object file.
 310 .Sp
 311 File segments may be relocated to nonstandard addresses, for example by
 312 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
 313 \&\fBld\fR.  However, some object file formats, such as a.out, do not
 314 store the starting address of the file segments.  In those situations,
 315 although \fBld\fR relocates the sections correctly, using \fBobjdump
 316 \&\-h\fR to list the file section headers cannot show the correct addresses.
 317 Instead, it shows the usual addresses, which are implicit for the
 318 target.
 319 .IP "\fB\-H\fR" 4
 320 .IX Item "-H"
 321 .PD 0
 322 .IP "\fB\-\-help\fR" 4
 323 .IX Item "--help"
 324 .PD
 325 Print a summary of the options to \fBobjdump\fR and exit.
 326 .IP "\fB\-i\fR" 4
 327 .IX Item "-i"
 328 .PD 0
 329 .IP "\fB\-\-info\fR" 4
 330 .IX Item "--info"
 331 .PD
 332 Display a list showing all architectures and object formats available
 333 for specification with \fB\-b\fR or \fB\-m\fR.
 334 .IP "\fB\-j\fR \fIname\fR" 4
 335 .IX Item "-j name"
 336 .PD 0
 337 .IP "\fB\-\-section=\fR\fIname\fR" 4
 338 .IX Item "--section=name"
 339 .PD
 340 Display information only for section \fIname\fR.
 341 .IP "\fB\-l\fR" 4
 342 .IX Item "-l"
 343 .PD 0
 344 .IP "\fB\-\-line\-numbers\fR" 4
 345 .IX Item "--line-numbers"
 346 .PD
 347 Label the display (using debugging information) with the filename and
 348 source line numbers corresponding to the object code or relocs shown.
 349 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
 350 .IP "\fB\-m\fR \fImachine\fR" 4
 351 .IX Item "-m machine"
 352 .PD 0
 353 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
 354 .IX Item "--architecture=machine"
 355 .PD
 356 Specify the architecture to use when disassembling object files.  This
 357 can be useful when disassembling object files which do not describe
 358 architecture information, such as S\-records.  You can list the available
 359 architectures with the \fB\-i\fR option.
 360 .IP "\fB\-M\fR \fIoptions\fR" 4
 361 .IX Item "-M options"
 362 .PD 0
 363 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
 364 .IX Item "--disassembler-options=options"
 365 .PD
 366 Pass target specific information to the disassembler.  Only supported on
 367 some targets.  If it is necessary to specify more than one
 368 disassembler option then multiple \fB\-M\fR options can be used or
 369 can be placed together into a comma separated list.
 370 .Sp
 371 If the target is an \s-1ARM\s0 architecture then this switch can be used to
 372 select which register name set is used during disassembler.  Specifying
 373 \&\fB\-M reg-names-std\fR (the default) will select the register names as
 374 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
 375 \&'sp', register 14 called 'lr' and register 15 called 'pc'.  Specifying
 376 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
 377 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
 378 just use \fBr\fR followed by the register number.
 379 .Sp
 380 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
 381 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
 382 use the ARM/Thumb Procedure Call Standard naming conventions.  (Either
 383 with the normal register names or the special register names).
 384 .Sp
 385 This option can also be used for \s-1ARM\s0 architectures to force the
 386 disassembler to interpret all instructions as Thumb instructions by
 387 using the switch \fB\-\-disassembler\-options=force\-thumb\fR.  This can be
 388 useful when attempting to disassemble thumb code produced by other
 389 compilers.
 390 .Sp
 391 For the x86, some of the options duplicate functions of the \fB\-m\fR
 392 switch, but allow finer grained control.  Multiple selections from the
 393 following may be specified as a comma separated string.
 394 \&\fBx86\-64\fR, \fBi386\fR and \fBi8086\fR select disassembly for
 395 the given architecture.  \fBintel\fR and \fBatt\fR select between
 396 intel syntax mode and \s-1AT&T\s0 syntax mode.  \fBaddr32\fR,
 397 \&\fBaddr16\fR, \fBdata32\fR and \fBdata16\fR specify the default
 398 address size and operand size.  These four options will be overridden if
 399 \&\fBx86\-64\fR, \fBi386\fR or \fBi8086\fR appear later in the
 400 option string.  Lastly, \fBsuffix\fR, when in \s-1AT&T\s0 mode,
 401 instructs the disassembler to print a mnemonic suffix even when the
 402 suffix could be inferred by the operands.
 403 .Sp
 404 For \s-1PPC\s0, \fBbooke\fR, \fBbooke32\fR and \fBbooke64\fR select
 405 disassembly of BookE instructions.  \fB32\fR and \fB64\fR select
 406 PowerPC and PowerPC64 disassembly, respectively.  \fBe300\fR selects
 407 disassembly for the e300 family.
 408 .Sp
 409 For \s-1MIPS\s0, this option controls the printing of instruction mneumonic
 410 names and register names in disassembled instructions.  Multiple
 411 selections from the following may be specified as a comma separated
 412 string, and invalid options are ignored:
 413 .RS 4
 414 .ie n .IP """no\-aliases""" 4
 415 .el .IP "\f(CWno\-aliases\fR" 4
 416 .IX Item "no-aliases"
 417 Print the 'raw' instruction mneumonic instead of some pseudo
 418 instruction mneumonic.  I.E. print 'daddu' or 'or' instead of 'move',
 419 \&'sll' instead of 'nop', etc.
 420 .ie n .IP """gpr\-names=\f(CI\s-1ABI\s0\f(CW""" 4
 421 .el .IP "\f(CWgpr\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
 422 .IX Item "gpr-names=ABI"
 423 Print \s-1GPR\s0 (general\-purpose register) names as appropriate
 424 for the specified \s-1ABI\s0.  By default, \s-1GPR\s0 names are selected according to
 425 the \s-1ABI\s0 of the binary being disassembled.
 426 .ie n .IP """fpr\-names=\f(CI\s-1ABI\s0\f(CW""" 4
 427 .el .IP "\f(CWfpr\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
 428 .IX Item "fpr-names=ABI"
 429 Print \s-1FPR\s0 (floating\-point register) names as
 430 appropriate for the specified \s-1ABI\s0.  By default, \s-1FPR\s0 numbers are printed
 431 rather than names.
 432 .ie n .IP """cp0\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
 433 .el .IP "\f(CWcp0\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
 434 .IX Item "cp0-names=ARCH"
 435 Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names
 436 as appropriate for the \s-1CPU\s0 or architecture specified by
 437 \&\fI\s-1ARCH\s0\fR.  By default, \s-1CP0\s0 register names are selected according to
 438 the architecture and \s-1CPU\s0 of the binary being disassembled.
 439 .ie n .IP """hwr\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
 440 .el .IP "\f(CWhwr\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
 441 .IX Item "hwr-names=ARCH"
 442 Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
 443 as appropriate for the \s-1CPU\s0 or architecture specified by
 444 \&\fI\s-1ARCH\s0\fR.  By default, \s-1HWR\s0 names are selected according to
 445 the architecture and \s-1CPU\s0 of the binary being disassembled.
 446 .ie n .IP """reg\-names=\f(CI\s-1ABI\s0\f(CW""" 4
 447 .el .IP "\f(CWreg\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
 448 .IX Item "reg-names=ABI"
 449 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI\s0.
 450 .ie n .IP """reg\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
 451 .el .IP "\f(CWreg\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
 452 .IX Item "reg-names=ARCH"
 453 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
 454 as appropriate for the selected \s-1CPU\s0 or architecture.
 455 .RE
 456 .RS 4
 457 .Sp
 458 For any of the options listed above, \fI\s-1ABI\s0\fR or
 459 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
 460 rather than names, for the selected types of registers.
 461 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
 462 the \fB\-\-help\fR option.
 463 .Sp
 464 For \s-1VAX\s0, you can specify function entry addresses with \fB\-M
 465 entry:0xf00ba\fR.  You can use this multiple times to properly
 466 disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like
 467 \&\s-1ROM\s0 dumps).  In these cases, the function entry mask would otherwise
 468 be decoded as \s-1VAX\s0 instructions, which would probably lead the the rest
 469 of the function being wrongly disassembled.
 470 .RE
 471 .IP "\fB\-p\fR" 4
 472 .IX Item "-p"
 473 .PD 0
 474 .IP "\fB\-\-private\-headers\fR" 4
 475 .IX Item "--private-headers"
 476 .PD
 477 Print information that is specific to the object file format.  The exact
 478 information printed depends upon the object file format.  For some
 479 object file formats, no additional information is printed.
 480 .IP "\fB\-r\fR" 4
 481 .IX Item "-r"
 482 .PD 0
 483 .IP "\fB\-\-reloc\fR" 4
 484 .IX Item "--reloc"
 485 .PD
 486 Print the relocation entries of the file.  If used with \fB\-d\fR or
 487 \&\fB\-D\fR, the relocations are printed interspersed with the
 488 disassembly.
 489 .IP "\fB\-R\fR" 4
 490 .IX Item "-R"
 491 .PD 0
 492 .IP "\fB\-\-dynamic\-reloc\fR" 4
 493 .IX Item "--dynamic-reloc"
 494 .PD
 495 Print the dynamic relocation entries of the file.  This is only
 496 meaningful for dynamic objects, such as certain types of shared
 497 libraries.
 498 .IP "\fB\-s\fR" 4
 499 .IX Item "-s"
 500 .PD 0
 501 .IP "\fB\-\-full\-contents\fR" 4
 502 .IX Item "--full-contents"
 503 .PD
 504 Display the full contents of any sections requested.  By default all
 505 non-empty sections are displayed.
 506 .IP "\fB\-S\fR" 4
 507 .IX Item "-S"
 508 .PD 0
 509 .IP "\fB\-\-source\fR" 4
 510 .IX Item "--source"
 511 .PD
 512 Display source code intermixed with disassembly, if possible.  Implies
 513 \&\fB\-d\fR.
 514 .IP "\fB\-\-show\-raw\-insn\fR" 4
 515 .IX Item "--show-raw-insn"
 516 When disassembling instructions, print the instruction in hex as well as
 517 in symbolic form.  This is the default except when
 518 \&\fB\-\-prefix\-addresses\fR is used.
 519 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
 520 .IX Item "--no-show-raw-insn"
 521 When disassembling instructions, do not print the instruction bytes.
 522 This is the default when \fB\-\-prefix\-addresses\fR is used.
 523 .IP "\fB\-W\fR" 4
 524 .IX Item "-W"
 525 .PD 0
 526 .IP "\fB\-\-dwarf\fR" 4
 527 .IX Item "--dwarf"
 528 .PD
 529 Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
 530 are present.
 531 .IP "\fB\-G\fR" 4
 532 .IX Item "-G"
 533 .PD 0
 534 .IP "\fB\-\-stabs\fR" 4
 535 .IX Item "--stabs"
 536 .PD
 537 Display the full contents of any sections requested.  Display the
 538 contents of the .stab and .stab.index and .stab.excl sections from an
 539 \&\s-1ELF\s0 file.  This is only useful on systems (such as Solaris 2.0) in which
 540 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
 541 section.  In most other file formats, debugging symbol-table entries are
 542 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
 543 output.
 544 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
 545 .IX Item "--start-address=address"
 546 Start displaying data at the specified address.  This affects the output
 547 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
 548 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
 549 .IX Item "--stop-address=address"
 550 Stop displaying data at the specified address.  This affects the output
 551 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
 552 .IP "\fB\-t\fR" 4
 553 .IX Item "-t"
 554 .PD 0
 555 .IP "\fB\-\-syms\fR" 4
 556 .IX Item "--syms"
 557 .PD
 558 Print the symbol table entries of the file.
 559 This is similar to the information provided by the \fBnm\fR program.
 560 .IP "\fB\-T\fR" 4
 561 .IX Item "-T"
 562 .PD 0
 563 .IP "\fB\-\-dynamic\-syms\fR" 4
 564 .IX Item "--dynamic-syms"
 565 .PD
 566 Print the dynamic symbol table entries of the file.  This is only
 567 meaningful for dynamic objects, such as certain types of shared
 568 libraries.  This is similar to the information provided by the \fBnm\fR
 569 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
 570 .IP "\fB\-\-special\-syms\fR" 4
 571 .IX Item "--special-syms"
 572 When displaying symbols include those which the target considers to be
 573 special in some way and which would not normally be of interest to the
 574 user.
 575 .IP "\fB\-V\fR" 4
 576 .IX Item "-V"
 577 .PD 0
 578 .IP "\fB\-\-version\fR" 4
 579 .IX Item "--version"
 580 .PD
 581 Print the version number of \fBobjdump\fR and exit.
 582 .IP "\fB\-x\fR" 4
 583 .IX Item "-x"
 584 .PD 0
 585 .IP "\fB\-\-all\-headers\fR" 4
 586 .IX Item "--all-headers"
 587 .PD
 588 Display all available header information, including the symbol table and
 589 relocation entries.  Using \fB\-x\fR is equivalent to specifying all of
 590 \&\fB\-a \-f \-h \-p \-r \-t\fR.
 591 .IP "\fB\-w\fR" 4
 592 .IX Item "-w"
 593 .PD 0
 594 .IP "\fB\-\-wide\fR" 4
 595 .IX Item "--wide"
 596 .PD
 597 Format some lines for output devices that have more than 80 columns.
 598 Also do not truncate symbol names when they are displayed.
 599 .IP "\fB\-z\fR" 4
 600 .IX Item "-z"
 601 .PD 0
 602 .IP "\fB\-\-disassemble\-zeroes\fR" 4
 603 .IX Item "--disassemble-zeroes"
 604 .PD
 605 Normally the disassembly output will skip blocks of zeroes.  This
 606 option directs the disassembler to disassemble those blocks, just like
 607 any other data.
 608 .IP "\fB@\fR\fIfile\fR" 4
 609 .IX Item "@file"
 610 Read command-line options from \fIfile\fR.  The options read are
 611 inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
 612 does not exist, or cannot be read, then the option will be treated
 613 literally, and not removed.
 614 .Sp
 615 Options in \fIfile\fR are separated by whitespace.  A whitespace
 616 character may be included in an option by surrounding the entire
 617 option in either single or double quotes.  Any character (including a
 618 backslash) may be included by prefixing the character to be included
 619 with a backslash.  The \fIfile\fR may itself contain additional
 620 @\fIfile\fR options; any such options will be processed recursively.
 621 .SH "SEE ALSO"
 622 .IX Header "SEE ALSO"
 623 \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
 624 .SH "COPYRIGHT"
 625 .IX Header "COPYRIGHT"
 626 Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
 627 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
 628 .PP
 629 Permission is granted to copy, distribute and/or modify this document
 630 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 631 or any later version published by the Free Software Foundation;
 632 with no Invariant Sections, with no Front-Cover Texts, and with no
 633 Back-Cover Texts.  A copy of the license is included in the
 634 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".