gnu/usr.bin/binutils/objdump/objdump.1

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