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

   1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
   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.  | will give a
  29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
  30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
  31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
  32 .tr \(*W-|\(bv\*(Tr
  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 "2004-04-09" "binutils-2.14.91" "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\-G\fR|\fB\-\-stabs\fR]
 159         [\fB\-t\fR|\fB\-\-syms\fR]
 160         [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
 161         [\fB\-x\fR|\fB\-\-all\-headers\fR]
 162         [\fB\-w\fR|\fB\-\-wide\fR]
 163         [\fB\-\-start\-address=\fR\fIaddress\fR]
 164         [\fB\-\-stop\-address=\fR\fIaddress\fR]
 165         [\fB\-\-prefix\-addresses\fR]
 166         [\fB\-\-[no\-]show\-raw\-insn\fR]
 167         [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
 168         [\fB\-V\fR|\fB\-\-version\fR]
 169         [\fB\-H\fR|\fB\-\-help\fR]
 170         \fIobjfile\fR...
 171 .SH "DESCRIPTION"
 172 .IX Header "DESCRIPTION"
 173 \&\fBobjdump\fR displays information about one or more object files.
 174 The options control what particular information to display.  This
 175 information is mostly useful to programmers who are working on the
 176 compilation tools, as opposed to programmers who just want their
 177 program to compile and work.
 178 .PP
 179 \&\fIobjfile\fR... are the object files to be examined.  When you
 180 specify archives, \fBobjdump\fR shows information on each of the member
 181 object files.
 182 .SH "OPTIONS"
 183 .IX Header "OPTIONS"
 184 The long and short forms of options, shown here as alternatives, are
 185 equivalent.  At least one option from the list
 186 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
 187 .IP "\fB\-a\fR" 4
 188 .IX Item "-a"
 189 .PD 0
 190 .IP "\fB\-\-archive\-header\fR" 4
 191 .IX Item "--archive-header"
 192 .PD
 193 If any of the \fIobjfile\fR files are archives, display the archive
 194 header information (in a format similar to \fBls \-l\fR).  Besides the
 195 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
 196 the object file format of each archive member.
 197 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
 198 .IX Item "--adjust-vma=offset"
 199 When dumping information, first add \fIoffset\fR to all the section
 200 addresses.  This is useful if the section addresses do not correspond to
 201 the symbol table, which can happen when putting sections at particular
 202 addresses when using a format which can not represent section addresses,
 203 such as a.out.
 204 .IP "\fB\-b\fR \fIbfdname\fR" 4
 205 .IX Item "-b bfdname"
 206 .PD 0
 207 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
 208 .IX Item "--target=bfdname"
 209 .PD
 210 Specify that the object-code format for the object files is
 211 \&\fIbfdname\fR.  This option may not be necessary; \fIobjdump\fR can
 212 automatically recognize many formats.
 213 .Sp
 214 For example,
 215 .Sp
 216 .Vb 1
 217 \&        objdump -b oasys -m vax -h fu.o
 218 .Ve
 219 .Sp
 220 displays summary information from the section headers (\fB\-h\fR) of
 221 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
 222 file in the format produced by Oasys compilers.  You can list the
 223 formats available with the \fB\-i\fR option.
 224 .IP "\fB\-C\fR" 4
 225 .IX Item "-C"
 226 .PD 0
 227 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
 228 .IX Item "--demangle[=style]"
 229 .PD
 230 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
 231 Besides removing any initial underscore prepended by the system, this
 232 makes \*(C+ function names readable.  Different compilers have different
 233 mangling styles. The optional demangling style argument can be used to
 234 choose an appropriate demangling style for your compiler.
 235 .IP "\fB\-g\fR" 4
 236 .IX Item "-g"
 237 .PD 0
 238 .IP "\fB\-\-debugging\fR" 4
 239 .IX Item "--debugging"
 240 .PD
 241 Display debugging information.  This attempts to parse debugging
 242 information stored in the file and print it out using a C like syntax.
 243 Only certain types of debugging information have been implemented.
 244 Some other types are supported by \fBreadelf \-w\fR.
 245 .IP "\fB\-e\fR" 4
 246 .IX Item "-e"
 247 .PD 0
 248 .IP "\fB\-\-debugging\-tags\fR" 4
 249 .IX Item "--debugging-tags"
 250 .PD
 251 Like \fB\-g\fR, but the information is generated in a format compatible
 252 with ctags tool.
 253 .IP "\fB\-d\fR" 4
 254 .IX Item "-d"
 255 .PD 0
 256 .IP "\fB\-\-disassemble\fR" 4
 257 .IX Item "--disassemble"
 258 .PD
 259 Display the assembler mnemonics for the machine instructions from
 260 \&\fIobjfile\fR.  This option only disassembles those sections which are
 261 expected to contain instructions.
 262 .IP "\fB\-D\fR" 4
 263 .IX Item "-D"
 264 .PD 0
 265 .IP "\fB\-\-disassemble\-all\fR" 4
 266 .IX Item "--disassemble-all"
 267 .PD
 268 Like \fB\-d\fR, but disassemble the contents of all sections, not just
 269 those expected to contain instructions.
 270 .IP "\fB\-\-prefix\-addresses\fR" 4
 271 .IX Item "--prefix-addresses"
 272 When disassembling, print the complete address on each line.  This is
 273 the older disassembly format.
 274 .IP "\fB\-EB\fR" 4
 275 .IX Item "-EB"
 276 .PD 0
 277 .IP "\fB\-EL\fR" 4
 278 .IX Item "-EL"
 279 .IP "\fB\-\-endian={big|little}\fR" 4
 280 .IX Item "--endian={big|little}"
 281 .PD
 282 Specify the endianness of the object files.  This only affects
 283 disassembly.  This can be useful when disassembling a file format which
 284 does not describe endianness information, such as S\-records.
 285 .IP "\fB\-f\fR" 4
 286 .IX Item "-f"
 287 .PD 0
 288 .IP "\fB\-\-file\-headers\fR" 4
 289 .IX Item "--file-headers"
 290 .PD
 291 Display summary information from the overall header of
 292 each of the \fIobjfile\fR files.
 293 .IP "\fB\-\-file\-start\-context\fR" 4
 294 .IX Item "--file-start-context"
 295 Specify that when displaying interlisted source code/disassembly
 296 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
 297 context to the start of the file.
 298 .IP "\fB\-h\fR" 4
 299 .IX Item "-h"
 300 .PD 0
 301 .IP "\fB\-\-section\-headers\fR" 4
 302 .IX Item "--section-headers"
 303 .IP "\fB\-\-headers\fR" 4
 304 .IX Item "--headers"
 305 .PD
 306 Display summary information from the section headers of the
 307 object file.
 308 .Sp
 309 File segments may be relocated to nonstandard addresses, for example by
 310 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
 311 \&\fBld\fR.  However, some object file formats, such as a.out, do not
 312 store the starting address of the file segments.  In those situations,
 313 although \fBld\fR relocates the sections correctly, using \fBobjdump
 314 \&\-h\fR to list the file section headers cannot show the correct addresses.
 315 Instead, it shows the usual addresses, which are implicit for the
 316 target.
 317 .IP "\fB\-H\fR" 4
 318 .IX Item "-H"
 319 .PD 0
 320 .IP "\fB\-\-help\fR" 4
 321 .IX Item "--help"
 322 .PD
 323 Print a summary of the options to \fBobjdump\fR and exit.
 324 .IP "\fB\-i\fR" 4
 325 .IX Item "-i"
 326 .PD 0
 327 .IP "\fB\-\-info\fR" 4
 328 .IX Item "--info"
 329 .PD
 330 Display a list showing all architectures and object formats available
 331 for specification with \fB\-b\fR or \fB\-m\fR.
 332 .IP "\fB\-j\fR \fIname\fR" 4
 333 .IX Item "-j name"
 334 .PD 0
 335 .IP "\fB\-\-section=\fR\fIname\fR" 4
 336 .IX Item "--section=name"
 337 .PD
 338 Display information only for section \fIname\fR.
 339 .IP "\fB\-l\fR" 4
 340 .IX Item "-l"
 341 .PD 0
 342 .IP "\fB\-\-line\-numbers\fR" 4
 343 .IX Item "--line-numbers"
 344 .PD
 345 Label the display (using debugging information) with the filename and
 346 source line numbers corresponding to the object code or relocs shown.
 347 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
 348 .IP "\fB\-m\fR \fImachine\fR" 4
 349 .IX Item "-m machine"
 350 .PD 0
 351 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
 352 .IX Item "--architecture=machine"
 353 .PD
 354 Specify the architecture to use when disassembling object files.  This
 355 can be useful when disassembling object files which do not describe
 356 architecture information, such as S\-records.  You can list the available
 357 architectures with the \fB\-i\fR option.
 358 .IP "\fB\-M\fR \fIoptions\fR" 4
 359 .IX Item "-M options"
 360 .PD 0
 361 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
 362 .IX Item "--disassembler-options=options"
 363 .PD
 364 Pass target specific information to the disassembler.  Only supported on
 365 some targets.  If it is necessary to specify more than one
 366 disassembler option then multiple \fB\-M\fR options can be used or
 367 can be placed together into a comma separated list.
 368 .Sp
 369 If the target is an \s-1ARM\s0 architecture then this switch can be used to
 370 select which register name set is used during disassembler.  Specifying
 371 \&\fB\-M reg-name-std\fR (the default) will select the register names as
 372 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
 373 \&'sp', register 14 called 'lr' and register 15 called 'pc'.  Specifying
 374 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
 375 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
 376 just use \fBr\fR followed by the register number.
 377 .Sp
 378 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
 379 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
 380 use the ARM/Thumb Procedure Call Standard naming conventions.  (Either
 381 with the normal register names or the special register names).
 382 .Sp
 383 This option can also be used for \s-1ARM\s0 architectures to force the
 384 disassembler to interpret all instructions as Thumb instructions by
 385 using the switch \fB\-\-disassembler\-options=force\-thumb\fR.  This can be
 386 useful when attempting to disassemble thumb code produced by other
 387 compilers.
 388 .Sp
 389 For the x86, some of the options duplicate functions of the \fB\-m\fR
 390 switch, but allow finer grained control.  Multiple selections from the
 391 following may be specified as a comma separated string.
 392 \&\fBx86\-64\fR, \fBi386\fR and \fBi8086\fR select disassembly for
 393 the given architecture.  \fBintel\fR and \fBatt\fR select between
 394 intel syntax mode and \s-1AT&T\s0 syntax mode.  \fBaddr32\fR,
 395 \&\fBaddr16\fR, \fBdata32\fR and \fBdata16\fR specify the default
 396 address size and operand size.  These four options will be overridden if
 397 \&\fBx86\-64\fR, \fBi386\fR or \fBi8086\fR appear later in the
 398 option string.  Lastly, \fBsuffix\fR, when in \s-1AT&T\s0 mode,
 399 instructs the disassembler to print a mnemonic suffix even when the
 400 suffix could be inferred by the operands.
 401 .Sp
 402 For \s-1PPC\s0, \fBbooke\fR, \fBbooke32\fR and \fBbooke64\fR select
 403 disassembly of BookE instructions.  \fB32\fR and \fB64\fR select
 404 PowerPC and PowerPC64 disassembly, respectively.
 405 .Sp
 406 For \s-1MIPS\s0, this option controls the printing of register names in
 407 disassembled instructions.  Multiple selections from the
 408 following may be specified as a comma separated string, and invalid
 409 options are ignored:
 410 .RS 4
 411 .ie n .IP """gpr\-names=\f(CI\s-1ABI\s0\f(CW""" 4
 412 .el .IP "\f(CWgpr\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
 413 .IX Item "gpr-names=ABI"
 414 Print \s-1GPR\s0 (general\-purpose register) names as appropriate
 415 for the specified \s-1ABI\s0.  By default, \s-1GPR\s0 names are selected according to
 416 the \s-1ABI\s0 of the binary being disassembled.
 417 .ie n .IP """fpr\-names=\f(CI\s-1ABI\s0\f(CW""" 4
 418 .el .IP "\f(CWfpr\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
 419 .IX Item "fpr-names=ABI"
 420 Print \s-1FPR\s0 (floating\-point register) names as
 421 appropriate for the specified \s-1ABI\s0.  By default, \s-1FPR\s0 numbers are printed
 422 rather than names.
 423 .ie n .IP """cp0\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
 424 .el .IP "\f(CWcp0\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
 425 .IX Item "cp0-names=ARCH"
 426 Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names
 427 as appropriate for the \s-1CPU\s0 or architecture specified by
 428 \&\fI\s-1ARCH\s0\fR.  By default, \s-1CP0\s0 register names are selected according to
 429 the architecture and \s-1CPU\s0 of the binary being disassembled.
 430 .ie n .IP """hwr\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
 431 .el .IP "\f(CWhwr\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
 432 .IX Item "hwr-names=ARCH"
 433 Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
 434 as appropriate for the \s-1CPU\s0 or architecture specified by
 435 \&\fI\s-1ARCH\s0\fR.  By default, \s-1HWR\s0 names are selected according to
 436 the architecture and \s-1CPU\s0 of the binary being disassembled.
 437 .ie n .IP """reg\-names=\f(CI\s-1ABI\s0\f(CW""" 4
 438 .el .IP "\f(CWreg\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
 439 .IX Item "reg-names=ABI"
 440 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI\s0.
 441 .ie n .IP """reg\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
 442 .el .IP "\f(CWreg\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
 443 .IX Item "reg-names=ARCH"
 444 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
 445 as appropriate for the selected \s-1CPU\s0 or architecture.
 446 .RE
 447 .RS 4
 448 .Sp
 449 For any of the options listed above, \fI\s-1ABI\s0\fR or
 450 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
 451 rather than names, for the selected types of registers.
 452 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
 453 the \fB\-\-help\fR option.
 454 .RE
 455 .IP "\fB\-p\fR" 4
 456 .IX Item "-p"
 457 .PD 0
 458 .IP "\fB\-\-private\-headers\fR" 4
 459 .IX Item "--private-headers"
 460 .PD
 461 Print information that is specific to the object file format.  The exact
 462 information printed depends upon the object file format.  For some
 463 object file formats, no additional information is printed.
 464 .IP "\fB\-r\fR" 4
 465 .IX Item "-r"
 466 .PD 0
 467 .IP "\fB\-\-reloc\fR" 4
 468 .IX Item "--reloc"
 469 .PD
 470 Print the relocation entries of the file.  If used with \fB\-d\fR or
 471 \&\fB\-D\fR, the relocations are printed interspersed with the
 472 disassembly.
 473 .IP "\fB\-R\fR" 4
 474 .IX Item "-R"
 475 .PD 0
 476 .IP "\fB\-\-dynamic\-reloc\fR" 4
 477 .IX Item "--dynamic-reloc"
 478 .PD
 479 Print the dynamic relocation entries of the file.  This is only
 480 meaningful for dynamic objects, such as certain types of shared
 481 libraries.
 482 .IP "\fB\-s\fR" 4
 483 .IX Item "-s"
 484 .PD 0
 485 .IP "\fB\-\-full\-contents\fR" 4
 486 .IX Item "--full-contents"
 487 .PD
 488 Display the full contents of any sections requested.  By default all
 489 non-empty sections are displayed.
 490 .IP "\fB\-S\fR" 4
 491 .IX Item "-S"
 492 .PD 0
 493 .IP "\fB\-\-source\fR" 4
 494 .IX Item "--source"
 495 .PD
 496 Display source code intermixed with disassembly, if possible.  Implies
 497 \&\fB\-d\fR.
 498 .IP "\fB\-\-show\-raw\-insn\fR" 4
 499 .IX Item "--show-raw-insn"
 500 When disassembling instructions, print the instruction in hex as well as
 501 in symbolic form.  This is the default except when
 502 \&\fB\-\-prefix\-addresses\fR is used.
 503 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
 504 .IX Item "--no-show-raw-insn"
 505 When disassembling instructions, do not print the instruction bytes.
 506 This is the default when \fB\-\-prefix\-addresses\fR is used.
 507 .IP "\fB\-G\fR" 4
 508 .IX Item "-G"
 509 .PD 0
 510 .IP "\fB\-\-stabs\fR" 4
 511 .IX Item "--stabs"
 512 .PD
 513 Display the full contents of any sections requested.  Display the
 514 contents of the .stab and .stab.index and .stab.excl sections from an
 515 \&\s-1ELF\s0 file.  This is only useful on systems (such as Solaris 2.0) in which
 516 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
 517 section.  In most other file formats, debugging symbol-table entries are
 518 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
 519 output.
 520 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
 521 .IX Item "--start-address=address"
 522 Start displaying data at the specified address.  This affects the output
 523 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
 524 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
 525 .IX Item "--stop-address=address"
 526 Stop displaying data at the specified address.  This affects the output
 527 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
 528 .IP "\fB\-t\fR" 4
 529 .IX Item "-t"
 530 .PD 0
 531 .IP "\fB\-\-syms\fR" 4
 532 .IX Item "--syms"
 533 .PD
 534 Print the symbol table entries of the file.
 535 This is similar to the information provided by the \fBnm\fR program.
 536 .IP "\fB\-T\fR" 4
 537 .IX Item "-T"
 538 .PD 0
 539 .IP "\fB\-\-dynamic\-syms\fR" 4
 540 .IX Item "--dynamic-syms"
 541 .PD
 542 Print the dynamic symbol table entries of the file.  This is only
 543 meaningful for dynamic objects, such as certain types of shared
 544 libraries.  This is similar to the information provided by the \fBnm\fR
 545 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
 546 .IP "\fB\-V\fR" 4
 547 .IX Item "-V"
 548 .PD 0
 549 .IP "\fB\-\-version\fR" 4
 550 .IX Item "--version"
 551 .PD
 552 Print the version number of \fBobjdump\fR and exit.
 553 .IP "\fB\-x\fR" 4
 554 .IX Item "-x"
 555 .PD 0
 556 .IP "\fB\-\-all\-headers\fR" 4
 557 .IX Item "--all-headers"
 558 .PD
 559 Display all available header information, including the symbol table and
 560 relocation entries.  Using \fB\-x\fR is equivalent to specifying all of
 561 \&\fB\-a \-f \-h \-r \-t\fR.
 562 .IP "\fB\-w\fR" 4
 563 .IX Item "-w"
 564 .PD 0
 565 .IP "\fB\-\-wide\fR" 4
 566 .IX Item "--wide"
 567 .PD
 568 Format some lines for output devices that have more than 80 columns.
 569 Also do not truncate symbol names when they are displayed.
 570 .IP "\fB\-z\fR" 4
 571 .IX Item "-z"
 572 .PD 0
 573 .IP "\fB\-\-disassemble\-zeroes\fR" 4
 574 .IX Item "--disassemble-zeroes"
 575 .PD
 576 Normally the disassembly output will skip blocks of zeroes.  This
 577 option directs the disassembler to disassemble those blocks, just like
 578 any other data.
 579 .SH "SEE ALSO"
 580 .IX Header "SEE ALSO"
 581 \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
 582 .SH "COPYRIGHT"
 583 .IX Header "COPYRIGHT"
 584 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000,
 585 2001, 2002, 2003 Free Software Foundation, Inc.
 586 .PP
 587 Permission is granted to copy, distribute and/or modify this document
 588 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 589 or any later version published by the Free Software Foundation;
 590 with no Invariant Sections, with no Front-Cover Texts, and with no
 591 Back-Cover Texts.  A copy of the license is included in the
 592 section entitled ``\s-1GNU\s0 Free Documentation License''.