share/man/man1/objdump.1

   1 .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
   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 .    ds C`
  42 .    ds C'
  43 'br\}
  44 .\"
  45 .\" Escape single quotes in literal strings from groff's Unicode transform.
  46 .ie \n(.g .ds Aq \(aq
  47 .el       .ds Aq '
  48 .\"
  49 .\" If the F register is >0, we'll generate index entries on stderr for
  50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  52 .\" output yourself in some meaningful fashion.
  53 .\"
  54 .\" Avoid warning from groff about undefined register 'F'.
  55 .de IX
  56 ..
  57 .nr rF 0
  58 .if \n(.g .if rF .nr rF 1
  59 .if (\n(rF:(\n(.g==0)) \{\
  60 .    if \nF \{\
  61 .        de IX
  62 .        tm Index:\\$1\t\\n%\t"\\$2"
  63 ..
  64 .        if !\nF==2 \{\
  65 .            nr % 0
  66 .            nr F 2
  67 .        \}
  68 .    \}
  69 .\}
  70 .rr rF
  71 .\"
  72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  73 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  74 .    \" fudge factors for nroff and troff
  75 .if n \{\
  76 .    ds #H 0
  77 .    ds #V .8m
  78 .    ds #F .3m
  79 .    ds #[ \f1
  80 .    ds #] \fP
  81 .\}
  82 .if t \{\
  83 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  84 .    ds #V .6m
  85 .    ds #F 0
  86 .    ds #[ \&
  87 .    ds #] \&
  88 .\}
  89 .    \" simple accents for nroff and troff
  90 .if n \{\
  91 .    ds ' \&
  92 .    ds ` \&
  93 .    ds ^ \&
  94 .    ds , \&
  95 .    ds ~ ~
  96 .    ds /
  97 .\}
  98 .if t \{\
  99 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 100 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 101 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 102 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 103 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 104 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 105 .\}
 106 .    \" troff and (daisy-wheel) nroff accents
 107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 114 .ds ae a\h'-(\w'a'u*4/10)'e
 115 .ds Ae A\h'-(\w'A'u*4/10)'E
 116 .    \" corrections for vroff
 117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 119 .    \" for low resolution devices (crt and lpr)
 120 .if \n(.H>23 .if \n(.V>19 \
 121 \{\
 122 .    ds : e
 123 .    ds 8 ss
 124 .    ds o a
 125 .    ds d- d\h'-1'\(ga
 126 .    ds D- D\h'-1'\(hy
 127 .    ds th \o'bp'
 128 .    ds Th \o'LP'
 129 .    ds ae ae
 130 .    ds Ae AE
 131 .\}
 132 .rm #[ #] #H #V #F C
 133 .\" ========================================================================
 134 .\"
 135 .IX Title "OBJDUMP 1"
 136 .TH OBJDUMP 1 "2023-04-26" "binutils-2.40.00" "GNU Development Tools"
 137 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 138 .\" way too many mistakes in technical documents.
 139 .if n .ad l
 140 .nh
 141 .SH "NAME"
 142 objdump \- display information from object files
 143 .SH "SYNOPSIS"
 144 .IX Header "SYNOPSIS"
 145 objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
 146         [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
 147         [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR] ]
 148         [\fB\-d\fR|\fB\-\-disassemble\fR[=\fIsymbol\fR]]
 149         [\fB\-D\fR|\fB\-\-disassemble\-all\fR]
 150         [\fB\-z\fR|\fB\-\-disassemble\-zeroes\fR]
 151         [\fB\-EB\fR|\fB\-EL\fR|\fB\-\-endian=\fR{big | little }]
 152         [\fB\-f\fR|\fB\-\-file\-headers\fR]
 153         [\fB\-F\fR|\fB\-\-file\-offsets\fR]
 154         [\fB\-\-file\-start\-context\fR]
 155         [\fB\-g\fR|\fB\-\-debugging\fR]
 156         [\fB\-e\fR|\fB\-\-debugging\-tags\fR]
 157         [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR]
 158         [\fB\-i\fR|\fB\-\-info\fR]
 159         [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR]
 160         [\fB\-l\fR|\fB\-\-line\-numbers\fR]
 161         [\fB\-S\fR|\fB\-\-source\fR]
 162         [\fB\-\-source\-comment\fR[=\fItext\fR]]
 163         [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR]
 164         [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR]
 165         [\fB\-p\fR|\fB\-\-private\-headers\fR]
 166         [\fB\-P\fR \fIoptions\fR|\fB\-\-private=\fR\fIoptions\fR]
 167         [\fB\-r\fR|\fB\-\-reloc\fR]
 168         [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
 169         [\fB\-s\fR|\fB\-\-full\-contents\fR]
 170         [\fB\-W[lLiaprmfFsoORtUuTgAck]\fR|
 171          \fB\-\-dwarf\fR[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=str\-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links]]
 172         [\fB\-WK\fR|\fB\-\-dwarf=follow\-links\fR]
 173         [\fB\-WN\fR|\fB\-\-dwarf=no\-follow\-links\fR]
 174         [\fB\-wD\fR|\fB\-\-dwarf=use\-debuginfod\fR]
 175         [\fB\-wE\fR|\fB\-\-dwarf=do\-not\-use\-debuginfod\fR]
 176         [\fB\-L\fR|\fB\-\-process\-links\fR]
 177         [\fB\-\-ctf=\fR\fIsection\fR]
 178         [\fB\-\-sframe=\fR\fIsection\fR]
 179         [\fB\-G\fR|\fB\-\-stabs\fR]
 180         [\fB\-t\fR|\fB\-\-syms\fR]
 181         [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
 182         [\fB\-x\fR|\fB\-\-all\-headers\fR]
 183         [\fB\-w\fR|\fB\-\-wide\fR]
 184         [\fB\-\-start\-address=\fR\fIaddress\fR]
 185         [\fB\-\-stop\-address=\fR\fIaddress\fR]
 186         [\fB\-\-no\-addresses\fR]
 187         [\fB\-\-prefix\-addresses\fR]
 188         [\fB\-\-[no\-]show\-raw\-insn\fR]
 189         [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
 190         [\fB\-\-show\-all\-symbols\fR]
 191         [\fB\-\-dwarf\-depth=\fR\fIn\fR]
 192         [\fB\-\-dwarf\-start=\fR\fIn\fR]
 193         [\fB\-\-ctf\-parent=\fR\fIsection\fR]
 194         [\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]
 195         [\fB\-\-special\-syms\fR]
 196         [\fB\-\-prefix=\fR\fIprefix\fR]
 197         [\fB\-\-prefix\-strip=\fR\fIlevel\fR]
 198         [\fB\-\-insn\-width=\fR\fIwidth\fR]
 199         [\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR
 200         [\fB\-\-disassembler\-color=[off|terminal|on|extended]\fR
 201         [\fB\-U\fR \fImethod\fR] [\fB\-\-unicode=\fR\fImethod\fR]
 202         [\fB\-V\fR|\fB\-\-version\fR]
 203         [\fB\-H\fR|\fB\-\-help\fR]
 204         \fIobjfile\fR...
 205 .SH "DESCRIPTION"
 206 .IX Header "DESCRIPTION"
 207 \&\fBobjdump\fR displays information about one or more object files.
 208 The options control what particular information to display.  This
 209 information is mostly useful to programmers who are working on the
 210 compilation tools, as opposed to programmers who just want their
 211 program to compile and work.
 212 .PP
 213 \&\fIobjfile\fR... are the object files to be examined.  When you
 214 specify archives, \fBobjdump\fR shows information on each of the member
 215 object files.
 216 .SH "OPTIONS"
 217 .IX Header "OPTIONS"
 218 The long and short forms of options, shown here as alternatives, are
 219 equivalent.  At least one option from the list
 220 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-P,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
 221 .IP "\fB\-a\fR" 4
 222 .IX Item "-a"
 223 .PD 0
 224 .IP "\fB\-\-archive\-header\fR" 4
 225 .IX Item "--archive-header"
 226 .PD
 227 If any of the \fIobjfile\fR files are archives, display the archive
 228 header information (in a format similar to \fBls \-l\fR).  Besides the
 229 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
 230 the object file format of each archive member.
 231 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
 232 .IX Item "--adjust-vma=offset"
 233 When dumping information, first add \fIoffset\fR to all the section
 234 addresses.  This is useful if the section addresses do not correspond to
 235 the symbol table, which can happen when putting sections at particular
 236 addresses when using a format which can not represent section addresses,
 237 such as a.out.
 238 .IP "\fB\-b\fR \fIbfdname\fR" 4
 239 .IX Item "-b bfdname"
 240 .PD 0
 241 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
 242 .IX Item "--target=bfdname"
 243 .PD
 244 Specify that the object-code format for the object files is
 245 \&\fIbfdname\fR.  This option may not be necessary; \fIobjdump\fR can
 246 automatically recognize many formats.
 247 .Sp
 248 For example,
 249 .Sp
 250 .Vb 1
 251 \&        objdump \-b oasys \-m vax \-h fu.o
 252 .Ve
 253 .Sp
 254 displays summary information from the section headers (\fB\-h\fR) of
 255 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
 256 file in the format produced by Oasys compilers.  You can list the
 257 formats available with the \fB\-i\fR option.
 258 .IP "\fB\-C\fR" 4
 259 .IX Item "-C"
 260 .PD 0
 261 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
 262 .IX Item "--demangle[=style]"
 263 .PD
 264 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
 265 Besides removing any initial underscore prepended by the system, this
 266 makes \*(C+ function names readable.  Different compilers have different
 267 mangling styles. The optional demangling style argument can be used to
 268 choose an appropriate demangling style for your compiler.
 269 .IP "\fB\-\-recurse\-limit\fR" 4
 270 .IX Item "--recurse-limit"
 271 .PD 0
 272 .IP "\fB\-\-no\-recurse\-limit\fR" 4
 273 .IX Item "--no-recurse-limit"
 274 .IP "\fB\-\-recursion\-limit\fR" 4
 275 .IX Item "--recursion-limit"
 276 .IP "\fB\-\-no\-recursion\-limit\fR" 4
 277 .IX Item "--no-recursion-limit"
 278 .PD
 279 Enables or disables a limit on the amount of recursion performed
 280 whilst demangling strings.  Since the name mangling formats allow for
 281 an infinite level of recursion it is possible to create strings whose
 282 decoding will exhaust the amount of stack space available on the host
 283 machine, triggering a memory fault.  The limit tries to prevent this
 284 from happening by restricting recursion to 2048 levels of nesting.
 285 .Sp
 286 The default is for this limit to be enabled, but disabling it may be
 287 necessary in order to demangle truly complicated names.  Note however
 288 that if the recursion limit is disabled then stack exhaustion is
 289 possible and any bug reports about such an event will be rejected.
 290 .IP "\fB\-g\fR" 4
 291 .IX Item "-g"
 292 .PD 0
 293 .IP "\fB\-\-debugging\fR" 4
 294 .IX Item "--debugging"
 295 .PD
 296 Display debugging information.  This attempts to parse \s-1STABS\s0
 297 debugging format information stored in the file and print it out using
 298 a C like syntax.  If no \s-1STABS\s0 debugging was found this option
 299 falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
 300 the file.
 301 .IP "\fB\-e\fR" 4
 302 .IX Item "-e"
 303 .PD 0
 304 .IP "\fB\-\-debugging\-tags\fR" 4
 305 .IX Item "--debugging-tags"
 306 .PD
 307 Like \fB\-g\fR, but the information is generated in a format compatible
 308 with ctags tool.
 309 .IP "\fB\-d\fR" 4
 310 .IX Item "-d"
 311 .PD 0
 312 .IP "\fB\-\-disassemble\fR" 4
 313 .IX Item "--disassemble"
 314 .IP "\fB\-\-disassemble=\fR\fIsymbol\fR" 4
 315 .IX Item "--disassemble=symbol"
 316 .PD
 317 Display the assembler mnemonics for the machine instructions from the
 318 input file.  This option only disassembles those sections which are
 319 expected to contain instructions.  If the optional \fIsymbol\fR
 320 argument is given, then display the assembler mnemonics starting at
 321 \&\fIsymbol\fR.  If \fIsymbol\fR is a function name then disassembly
 322 will stop at the end of the function, otherwise it will stop when the
 323 next symbol is encountered.  If there are no matches for \fIsymbol\fR
 324 then nothing will be displayed.
 325 .Sp
 326 Note if the \fB\-\-dwarf=follow\-links\fR option is enabled
 327 then any symbol tables in linked debug info files will be read in and
 328 used when disassembling.
 329 .IP "\fB\-D\fR" 4
 330 .IX Item "-D"
 331 .PD 0
 332 .IP "\fB\-\-disassemble\-all\fR" 4
 333 .IX Item "--disassemble-all"
 334 .PD
 335 Like \fB\-d\fR, but disassemble the contents of all sections, not just
 336 those expected to contain instructions.
 337 .Sp
 338 This option also has a subtle effect on the disassembly of
 339 instructions in code sections.  When option \fB\-d\fR is in effect
 340 objdump will assume that any symbols present in a code section occur
 341 on the boundary between instructions and it will refuse to disassemble
 342 across such a boundary.  When option \fB\-D\fR is in effect however
 343 this assumption is supressed.  This means that it is possible for the
 344 output of \fB\-d\fR and \fB\-D\fR to differ if, for example, data
 345 is stored in code sections.
 346 .Sp
 347 If the target is an \s-1ARM\s0 architecture this switch also has the effect
 348 of forcing the disassembler to decode pieces of data found in code
 349 sections as if they were instructions.
 350 .Sp
 351 Note if the \fB\-\-dwarf=follow\-links\fR option is enabled
 352 then any symbol tables in linked debug info files will be read in and
 353 used when disassembling.
 354 .IP "\fB\-\-no\-addresses\fR" 4
 355 .IX Item "--no-addresses"
 356 When disassembling, don't print addresses on each line or for symbols
 357 and relocation offsets.  In combination with \fB\-\-no\-show\-raw\-insn\fR
 358 this may be useful for comparing compiler output.
 359 .IP "\fB\-\-prefix\-addresses\fR" 4
 360 .IX Item "--prefix-addresses"
 361 When disassembling, print the complete address on each line.  This is
 362 the older disassembly format.
 363 .IP "\fB\-EB\fR" 4
 364 .IX Item "-EB"
 365 .PD 0
 366 .IP "\fB\-EL\fR" 4
 367 .IX Item "-EL"
 368 .IP "\fB\-\-endian={big|little}\fR" 4
 369 .IX Item "--endian={big|little}"
 370 .PD
 371 Specify the endianness of the object files.  This only affects
 372 disassembly.  This can be useful when disassembling a file format which
 373 does not describe endianness information, such as S\-records.
 374 .IP "\fB\-f\fR" 4
 375 .IX Item "-f"
 376 .PD 0
 377 .IP "\fB\-\-file\-headers\fR" 4
 378 .IX Item "--file-headers"
 379 .PD
 380 Display summary information from the overall header of
 381 each of the \fIobjfile\fR files.
 382 .IP "\fB\-F\fR" 4
 383 .IX Item "-F"
 384 .PD 0
 385 .IP "\fB\-\-file\-offsets\fR" 4
 386 .IX Item "--file-offsets"
 387 .PD
 388 When disassembling sections, whenever a symbol is displayed, also
 389 display the file offset of the region of data that is about to be
 390 dumped.  If zeroes are being skipped, then when disassembly resumes,
 391 tell the user how many zeroes were skipped and the file offset of the
 392 location from where the disassembly resumes.  When dumping sections,
 393 display the file offset of the location from where the dump starts.
 394 .IP "\fB\-\-file\-start\-context\fR" 4
 395 .IX Item "--file-start-context"
 396 Specify that when displaying interlisted source code/disassembly
 397 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
 398 context to the start of the file.
 399 .IP "\fB\-h\fR" 4
 400 .IX Item "-h"
 401 .PD 0
 402 .IP "\fB\-\-section\-headers\fR" 4
 403 .IX Item "--section-headers"
 404 .IP "\fB\-\-headers\fR" 4
 405 .IX Item "--headers"
 406 .PD
 407 Display summary information from the section headers of the
 408 object file.
 409 .Sp
 410 File segments may be relocated to nonstandard addresses, for example by
 411 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
 412 \&\fBld\fR.  However, some object file formats, such as a.out, do not
 413 store the starting address of the file segments.  In those situations,
 414 although \fBld\fR relocates the sections correctly, using \fBobjdump
 415 \&\-h\fR to list the file section headers cannot show the correct addresses.
 416 Instead, it shows the usual addresses, which are implicit for the
 417 target.
 418 .Sp
 419 Note, in some cases it is possible for a section to have both the
 420 \&\s-1READONLY\s0 and the \s-1NOREAD\s0 attributes set.  In such cases the \s-1NOREAD\s0
 421 attribute takes precedence, but \fBobjdump\fR will report both
 422 since the exact setting of the flag bits might be important.
 423 .IP "\fB\-H\fR" 4
 424 .IX Item "-H"
 425 .PD 0
 426 .IP "\fB\-\-help\fR" 4
 427 .IX Item "--help"
 428 .PD
 429 Print a summary of the options to \fBobjdump\fR and exit.
 430 .IP "\fB\-i\fR" 4
 431 .IX Item "-i"
 432 .PD 0
 433 .IP "\fB\-\-info\fR" 4
 434 .IX Item "--info"
 435 .PD
 436 Display a list showing all architectures and object formats available
 437 for specification with \fB\-b\fR or \fB\-m\fR.
 438 .IP "\fB\-j\fR \fIname\fR" 4
 439 .IX Item "-j name"
 440 .PD 0
 441 .IP "\fB\-\-section=\fR\fIname\fR" 4
 442 .IX Item "--section=name"
 443 .PD
 444 Display information only for section \fIname\fR.
 445 .IP "\fB\-L\fR" 4
 446 .IX Item "-L"
 447 .PD 0
 448 .IP "\fB\-\-process\-links\fR" 4
 449 .IX Item "--process-links"
 450 .PD
 451 Display the contents of non-debug sections found in separate debuginfo
 452 files that are linked to the main file.  This option automatically
 453 implies the \fB\-WK\fR option, and only sections requested by other
 454 command line options will be displayed.
 455 .IP "\fB\-l\fR" 4
 456 .IX Item "-l"
 457 .PD 0
 458 .IP "\fB\-\-line\-numbers\fR" 4
 459 .IX Item "--line-numbers"
 460 .PD
 461 Label the display (using debugging information) with the filename and
 462 source line numbers corresponding to the object code or relocs shown.
 463 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
 464 .IP "\fB\-m\fR \fImachine\fR" 4
 465 .IX Item "-m machine"
 466 .PD 0
 467 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
 468 .IX Item "--architecture=machine"
 469 .PD
 470 Specify the architecture to use when disassembling object files.  This
 471 can be useful when disassembling object files which do not describe
 472 architecture information, such as S\-records.  You can list the available
 473 architectures with the \fB\-i\fR option.
 474 .Sp
 475 For most architectures it is possible to supply an architecture
 476 name and a machine name, separated by a colon.  For example
 477 \&\fBfoo:bar\fR would refer to the \fBbar\fR machine type in the
 478 \&\fBfoo\fR architecture.  This can be helpful if objdump has been
 479 configured to support multiple architectures.
 480 .Sp
 481 If the target is an \s-1ARM\s0 architecture then this switch has an
 482 additional effect.  It restricts the disassembly to only those
 483 instructions supported by the architecture specified by \fImachine\fR.
 484 If it is necessary to use this switch because the input file does not
 485 contain any architecture information, but it is also desired to
 486 disassemble all the instructions use \fB\-marm\fR.
 487 .IP "\fB\-M\fR \fIoptions\fR" 4
 488 .IX Item "-M options"
 489 .PD 0
 490 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
 491 .IX Item "--disassembler-options=options"
 492 .PD
 493 Pass target specific information to the disassembler.  Only supported on
 494 some targets.  If it is necessary to specify more than one
 495 disassembler option then multiple \fB\-M\fR options can be used or
 496 can be placed together into a comma separated list.
 497 .Sp
 498 For \s-1ARC,\s0 \fBdsp\fR controls the printing of \s-1DSP\s0 instructions,
 499 \&\fBspfp\fR selects the printing of \s-1FPX\s0 single precision \s-1FP\s0
 500 instructions, \fBdpfp\fR selects the printing of \s-1FPX\s0 double
 501 precision \s-1FP\s0 instructions, \fBquarkse_em\fR selects the printing of
 502 special QuarkSE-EM instructions, \fBfpuda\fR selects the printing
 503 of double precision assist instructions, \fBfpus\fR selects the
 504 printing of \s-1FPU\s0 single precision \s-1FP\s0 instructions, while \fBfpud\fR
 505 selects the printing of \s-1FPU\s0 double precision \s-1FP\s0 instructions.
 506 Additionally, one can choose to have all the immediates printed in
 507 hexadecimal using \fBhex\fR.  By default, the short immediates are
 508 printed using the decimal representation, while the long immediate
 509 values are printed as hexadecimal.
 510 .Sp
 511 \&\fBcpu=...\fR allows one to enforce a particular \s-1ISA\s0 when disassembling
 512 instructions, overriding the \fB\-m\fR value or whatever is in the \s-1ELF\s0 file.
 513 This might be useful to select \s-1ARC EM\s0 or \s-1HS ISA,\s0 because architecture is same
 514 for those and disassembler relies on private \s-1ELF\s0 header data to decide if code
 515 is for \s-1EM\s0 or \s-1HS.\s0  This option might be specified multiple times \- only the
 516 latest value will be used.  Valid values are same as for the assembler
 517 \&\fB\-mcpu=...\fR option.
 518 .Sp
 519 If the target is an \s-1ARM\s0 architecture then this switch can be used to
 520 select which register name set is used during disassembler.  Specifying
 521 \&\fB\-M reg-names-std\fR (the default) will select the register names as
 522 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
 523 \&'sp', register 14 called 'lr' and register 15 called 'pc'.  Specifying
 524 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
 525 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
 526 just use \fBr\fR followed by the register number.
 527 .Sp
 528 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
 529 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
 530 use the ARM/Thumb Procedure Call Standard naming conventions.  (Either
 531 with the normal register names or the special register names).
 532 .Sp
 533 This option can also be used for \s-1ARM\s0 architectures to force the
 534 disassembler to interpret all instructions as Thumb instructions by
 535 using the switch \fB\-\-disassembler\-options=force\-thumb\fR.  This can be
 536 useful when attempting to disassemble thumb code produced by other
 537 compilers.
 538 .Sp
 539 For AArch64 targets this switch can be used to set whether instructions are
 540 disassembled as the most general instruction using the \fB\-M no-aliases\fR
 541 option or whether instruction notes should be generated as comments in the
 542 disasssembly using \fB\-M notes\fR.
 543 .Sp
 544 For the x86, some of the options duplicate functions of the \fB\-m\fR
 545 switch, but allow finer grained control.
 546 .RS 4
 547 .ie n .IP """x86\-64""" 4
 548 .el .IP "\f(CWx86\-64\fR" 4
 549 .IX Item "x86-64"
 550 .PD 0
 551 .ie n .IP """i386""" 4
 552 .el .IP "\f(CWi386\fR" 4
 553 .IX Item "i386"
 554 .ie n .IP """i8086""" 4
 555 .el .IP "\f(CWi8086\fR" 4
 556 .IX Item "i8086"
 557 .PD
 558 Select disassembly for the given architecture.
 559 .ie n .IP """intel""" 4
 560 .el .IP "\f(CWintel\fR" 4
 561 .IX Item "intel"
 562 .PD 0
 563 .ie n .IP """att""" 4
 564 .el .IP "\f(CWatt\fR" 4
 565 .IX Item "att"
 566 .PD
 567 Select between intel syntax mode and \s-1AT&T\s0 syntax mode.
 568 .ie n .IP """amd64""" 4
 569 .el .IP "\f(CWamd64\fR" 4
 570 .IX Item "amd64"
 571 .PD 0
 572 .ie n .IP """intel64""" 4
 573 .el .IP "\f(CWintel64\fR" 4
 574 .IX Item "intel64"
 575 .PD
 576 Select between \s-1AMD64 ISA\s0 and Intel64 \s-1ISA.\s0
 577 .ie n .IP """intel\-mnemonic""" 4
 578 .el .IP "\f(CWintel\-mnemonic\fR" 4
 579 .IX Item "intel-mnemonic"
 580 .PD 0
 581 .ie n .IP """att\-mnemonic""" 4
 582 .el .IP "\f(CWatt\-mnemonic\fR" 4
 583 .IX Item "att-mnemonic"
 584 .PD
 585 Select between intel mnemonic mode and \s-1AT&T\s0 mnemonic mode.
 586 Note: \f(CW\*(C`intel\-mnemonic\*(C'\fR implies \f(CW\*(C`intel\*(C'\fR and
 587 \&\f(CW\*(C`att\-mnemonic\*(C'\fR implies \f(CW\*(C`att\*(C'\fR.
 588 .ie n .IP """addr64""" 4
 589 .el .IP "\f(CWaddr64\fR" 4
 590 .IX Item "addr64"
 591 .PD 0
 592 .ie n .IP """addr32""" 4
 593 .el .IP "\f(CWaddr32\fR" 4
 594 .IX Item "addr32"
 595 .ie n .IP """addr16""" 4
 596 .el .IP "\f(CWaddr16\fR" 4
 597 .IX Item "addr16"
 598 .ie n .IP """data32""" 4
 599 .el .IP "\f(CWdata32\fR" 4
 600 .IX Item "data32"
 601 .ie n .IP """data16""" 4
 602 .el .IP "\f(CWdata16\fR" 4
 603 .IX Item "data16"
 604 .PD
 605 Specify the default address size and operand size.  These five options
 606 will be overridden if \f(CW\*(C`x86\-64\*(C'\fR, \f(CW\*(C`i386\*(C'\fR or \f(CW\*(C`i8086\*(C'\fR
 607 appear later in the option string.
 608 .ie n .IP """suffix""" 4
 609 .el .IP "\f(CWsuffix\fR" 4
 610 .IX Item "suffix"
 611 When in \s-1AT&T\s0 mode and also for a limited set of instructions when in Intel
 612 mode, instructs the disassembler to print a mnemonic suffix even when the
 613 suffix could be inferred by the operands or, for certain instructions, the
 614 execution mode's defaults.
 615 .RE
 616 .RS 4
 617 .Sp
 618 For PowerPC, the \fB\-M\fR argument \fBraw\fR selects
 619 disasssembly of hardware insns rather than aliases.  For example, you
 620 will see \f(CW\*(C`rlwinm\*(C'\fR rather than \f(CW\*(C`clrlwi\*(C'\fR, and \f(CW\*(C`addi\*(C'\fR
 621 rather than \f(CW\*(C`li\*(C'\fR.  All of the \fB\-m\fR arguments for
 622 \&\fBgas\fR that select a \s-1CPU\s0 are supported.  These are:
 623 \&\fB403\fR, \fB405\fR, \fB440\fR, \fB464\fR, \fB476\fR,
 624 \&\fB601\fR, \fB603\fR, \fB604\fR, \fB620\fR, \fB7400\fR,
 625 \&\fB7410\fR, \fB7450\fR, \fB7455\fR, \fB750cl\fR,
 626 \&\fB821\fR, \fB850\fR, \fB860\fR, \fBa2\fR, \fBbooke\fR,
 627 \&\fBbooke32\fR, \fBcell\fR, \fBcom\fR, \fBe200z2\fR, \fBe200z4\fR,
 628 \&\fBe300\fR, \fBe500\fR, \fBe500mc\fR, \fBe500mc64\fR,
 629 \&\fBe500x2\fR, \fBe5500\fR, \fBe6500\fR, \fBefs\fR,
 630 \&\fBpower4\fR, \fBpower5\fR, \fBpower6\fR, \fBpower7\fR,
 631 \&\fBpower8\fR, \fBpower9\fR, \fBpower10\fR, \fBppc\fR,
 632 \&\fBppc32\fR, \fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR,
 633 \&\fBpwr\fR, \fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR,
 634 \&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR, \fBpwr10\fR,
 635 \&\fBpwrx\fR, \fBtitan\fR, \fBvle\fR, and \fBfuture\fR.
 636 \&\fB32\fR and \fB64\fR modify the default or a prior \s-1CPU\s0
 637 selection, disabling and enabling 64\-bit insns respectively.  In
 638 addition, \fBaltivec\fR, \fBany\fR, \fBlsp\fR, \fBhtm\fR,
 639 \&\fBvsx\fR, \fBspe\fR and  \fBspe2\fR add capabilities to a
 640 previous \fIor later\fR \s-1CPU\s0 selection.
 641 \&\fBany\fR will disassemble any opcode known to
 642 binutils, but in cases where an opcode has two different meanings or
 643 different arguments, you may not see the disassembly you expect.
 644 If you disassemble without giving a \s-1CPU\s0 selection, a default will be
 645 chosen from information gleaned by \s-1BFD\s0 from the object files headers,
 646 but the result again may not be as you expect.
 647 .Sp
 648 For \s-1MIPS,\s0 this option controls the printing of instruction mnemonic
 649 names and register names in disassembled instructions.  Multiple
 650 selections from the following may be specified as a comma separated
 651 string, and invalid options are ignored:
 652 .ie n .IP """no\-aliases""" 4
 653 .el .IP "\f(CWno\-aliases\fR" 4
 654 .IX Item "no-aliases"
 655 Print the 'raw' instruction mnemonic instead of some pseudo
 656 instruction mnemonic.  I.e., print 'daddu' or 'or' instead of 'move',
 657 \&'sll' instead of 'nop', etc.
 658 .ie n .IP """msa""" 4
 659 .el .IP "\f(CWmsa\fR" 4
 660 .IX Item "msa"
 661 Disassemble \s-1MSA\s0 instructions.
 662 .ie n .IP """virt""" 4
 663 .el .IP "\f(CWvirt\fR" 4
 664 .IX Item "virt"
 665 Disassemble the virtualization \s-1ASE\s0 instructions.
 666 .ie n .IP """xpa""" 4
 667 .el .IP "\f(CWxpa\fR" 4
 668 .IX Item "xpa"
 669 Disassemble the eXtended Physical Address (\s-1XPA\s0) \s-1ASE\s0 instructions.
 670 .ie n .IP """gpr\-names=\fIABI\fP""" 4
 671 .el .IP "\f(CWgpr\-names=\f(CIABI\f(CW\fR" 4
 672 .IX Item "gpr-names=ABI"
 673 Print \s-1GPR\s0 (general-purpose register) names as appropriate
 674 for the specified \s-1ABI.\s0  By default, \s-1GPR\s0 names are selected according to
 675 the \s-1ABI\s0 of the binary being disassembled.
 676 .ie n .IP """fpr\-names=\fIABI\fP""" 4
 677 .el .IP "\f(CWfpr\-names=\f(CIABI\f(CW\fR" 4
 678 .IX Item "fpr-names=ABI"
 679 Print \s-1FPR\s0 (floating-point register) names as
 680 appropriate for the specified \s-1ABI.\s0  By default, \s-1FPR\s0 numbers are printed
 681 rather than names.
 682 .ie n .IP """cp0\-names=\fIARCH\fP""" 4
 683 .el .IP "\f(CWcp0\-names=\f(CIARCH\f(CW\fR" 4
 684 .IX Item "cp0-names=ARCH"
 685 Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names
 686 as appropriate for the \s-1CPU\s0 or architecture specified by
 687 \&\fI\s-1ARCH\s0\fR.  By default, \s-1CP0\s0 register names are selected according to
 688 the architecture and \s-1CPU\s0 of the binary being disassembled.
 689 .ie n .IP """hwr\-names=\fIARCH\fP""" 4
 690 .el .IP "\f(CWhwr\-names=\f(CIARCH\f(CW\fR" 4
 691 .IX Item "hwr-names=ARCH"
 692 Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
 693 as appropriate for the \s-1CPU\s0 or architecture specified by
 694 \&\fI\s-1ARCH\s0\fR.  By default, \s-1HWR\s0 names are selected according to
 695 the architecture and \s-1CPU\s0 of the binary being disassembled.
 696 .ie n .IP """reg\-names=\fIABI\fP""" 4
 697 .el .IP "\f(CWreg\-names=\f(CIABI\f(CW\fR" 4
 698 .IX Item "reg-names=ABI"
 699 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI.\s0
 700 .ie n .IP """reg\-names=\fIARCH\fP""" 4
 701 .el .IP "\f(CWreg\-names=\f(CIARCH\f(CW\fR" 4
 702 .IX Item "reg-names=ARCH"
 703 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
 704 as appropriate for the selected \s-1CPU\s0 or architecture.
 705 .RE
 706 .RS 4
 707 .Sp
 708 For any of the options listed above, \fI\s-1ABI\s0\fR or
 709 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
 710 rather than names, for the selected types of registers.
 711 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
 712 the \fB\-\-help\fR option.
 713 .Sp
 714 For \s-1VAX,\s0 you can specify function entry addresses with \fB\-M
 715 entry:0xf00ba\fR.  You can use this multiple times to properly
 716 disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like
 717 \&\s-1ROM\s0 dumps).  In these cases, the function entry mask would otherwise
 718 be decoded as \s-1VAX\s0 instructions, which would probably lead the rest
 719 of the function being wrongly disassembled.
 720 .RE
 721 .IP "\fB\-p\fR" 4
 722 .IX Item "-p"
 723 .PD 0
 724 .IP "\fB\-\-private\-headers\fR" 4
 725 .IX Item "--private-headers"
 726 .PD
 727 Print information that is specific to the object file format.  The exact
 728 information printed depends upon the object file format.  For some
 729 object file formats, no additional information is printed.
 730 .IP "\fB\-P\fR \fIoptions\fR" 4
 731 .IX Item "-P options"
 732 .PD 0
 733 .IP "\fB\-\-private=\fR\fIoptions\fR" 4
 734 .IX Item "--private=options"
 735 .PD
 736 Print information that is specific to the object file format.  The
 737 argument \fIoptions\fR is a comma separated list that depends on the
 738 format (the lists of options is displayed with the help).
 739 .Sp
 740 For \s-1XCOFF,\s0 the available options are:
 741 .RS 4
 742 .ie n .IP """header""" 4
 743 .el .IP "\f(CWheader\fR" 4
 744 .IX Item "header"
 745 .PD 0
 746 .ie n .IP """aout""" 4
 747 .el .IP "\f(CWaout\fR" 4
 748 .IX Item "aout"
 749 .ie n .IP """sections""" 4
 750 .el .IP "\f(CWsections\fR" 4
 751 .IX Item "sections"
 752 .ie n .IP """syms""" 4
 753 .el .IP "\f(CWsyms\fR" 4
 754 .IX Item "syms"
 755 .ie n .IP """relocs""" 4
 756 .el .IP "\f(CWrelocs\fR" 4
 757 .IX Item "relocs"
 758 .ie n .IP """lineno,""" 4
 759 .el .IP "\f(CWlineno,\fR" 4
 760 .IX Item "lineno,"
 761 .ie n .IP """loader""" 4
 762 .el .IP "\f(CWloader\fR" 4
 763 .IX Item "loader"
 764 .ie n .IP """except""" 4
 765 .el .IP "\f(CWexcept\fR" 4
 766 .IX Item "except"
 767 .ie n .IP """typchk""" 4
 768 .el .IP "\f(CWtypchk\fR" 4
 769 .IX Item "typchk"
 770 .ie n .IP """traceback""" 4
 771 .el .IP "\f(CWtraceback\fR" 4
 772 .IX Item "traceback"
 773 .ie n .IP """toc""" 4
 774 .el .IP "\f(CWtoc\fR" 4
 775 .IX Item "toc"
 776 .ie n .IP """ldinfo""" 4
 777 .el .IP "\f(CWldinfo\fR" 4
 778 .IX Item "ldinfo"
 779 .RE
 780 .RS 4
 781 .PD
 782 .Sp
 783 Not all object formats support this option.  In particular the \s-1ELF\s0
 784 format does not use it.
 785 .RE
 786 .IP "\fB\-r\fR" 4
 787 .IX Item "-r"
 788 .PD 0
 789 .IP "\fB\-\-reloc\fR" 4
 790 .IX Item "--reloc"
 791 .PD
 792 Print the relocation entries of the file.  If used with \fB\-d\fR or
 793 \&\fB\-D\fR, the relocations are printed interspersed with the
 794 disassembly.
 795 .IP "\fB\-R\fR" 4
 796 .IX Item "-R"
 797 .PD 0
 798 .IP "\fB\-\-dynamic\-reloc\fR" 4
 799 .IX Item "--dynamic-reloc"
 800 .PD
 801 Print the dynamic relocation entries of the file.  This is only
 802 meaningful for dynamic objects, such as certain types of shared
 803 libraries.  As for \fB\-r\fR, if used with \fB\-d\fR or
 804 \&\fB\-D\fR, the relocations are printed interspersed with the
 805 disassembly.
 806 .IP "\fB\-s\fR" 4
 807 .IX Item "-s"
 808 .PD 0
 809 .IP "\fB\-\-full\-contents\fR" 4
 810 .IX Item "--full-contents"
 811 .PD
 812 Display the full contents of any sections requested.  By default all
 813 non-empty sections are displayed.
 814 .IP "\fB\-S\fR" 4
 815 .IX Item "-S"
 816 .PD 0
 817 .IP "\fB\-\-source\fR" 4
 818 .IX Item "--source"
 819 .PD
 820 Display source code intermixed with disassembly, if possible.  Implies
 821 \&\fB\-d\fR.
 822 .IP "\fB\-\-show\-all\-symbols\fR" 4
 823 .IX Item "--show-all-symbols"
 824 When disassembling, show all the symbols that match a given address,
 825 not just the first one.
 826 .IP "\fB\-\-source\-comment[=\fR\fItxt\fR\fB]\fR" 4
 827 .IX Item "--source-comment[=txt]"
 828 Like the \fB\-S\fR option, but all source code lines are displayed
 829 with a prefix of \fItxt\fR.  Typically \fItxt\fR will be a comment
 830 string which can be used to distinguish the assembler code from the
 831 source code.  If \fItxt\fR is not provided then a default string of
 832 \&\fI\*(L"# \*(R"\fR (hash followed by a space), will be used.
 833 .IP "\fB\-\-prefix=\fR\fIprefix\fR" 4
 834 .IX Item "--prefix=prefix"
 835 Specify \fIprefix\fR to add to the absolute paths when used with
 836 \&\fB\-S\fR.
 837 .IP "\fB\-\-prefix\-strip=\fR\fIlevel\fR" 4
 838 .IX Item "--prefix-strip=level"
 839 Indicate how many initial directory names to strip off the hardwired
 840 absolute paths. It has no effect without \fB\-\-prefix=\fR\fIprefix\fR.
 841 .IP "\fB\-\-show\-raw\-insn\fR" 4
 842 .IX Item "--show-raw-insn"
 843 When disassembling instructions, print the instruction in hex as well as
 844 in symbolic form.  This is the default except when
 845 \&\fB\-\-prefix\-addresses\fR is used.
 846 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
 847 .IX Item "--no-show-raw-insn"
 848 When disassembling instructions, do not print the instruction bytes.
 849 This is the default when \fB\-\-prefix\-addresses\fR is used.
 850 .IP "\fB\-\-insn\-width=\fR\fIwidth\fR" 4
 851 .IX Item "--insn-width=width"
 852 Display \fIwidth\fR bytes on a single line when disassembling
 853 instructions.
 854 .IP "\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR" 4
 855 .IX Item "--visualize-jumps[=color|=extended-color|=off]"
 856 Visualize jumps that stay inside a function by drawing \s-1ASCII\s0 art between
 857 the start and target addresses.  The optional \fB=color\fR argument
 858 adds color to the output using simple terminal colors.  Alternatively
 859 the \fB=extended\-color\fR argument will add color using 8bit
 860 colors, but these might not work on all terminals.
 861 .Sp
 862 If it is necessary to disable the \fBvisualize-jumps\fR option
 863 after it has previously been enabled then use
 864 \&\fBvisualize\-jumps=off\fR.
 865 .IP "\fB\-\-disassembler\-color=off\fR" 4
 866 .IX Item "--disassembler-color=off"
 867 .PD 0
 868 .IP "\fB\-\-disassembler\-color=terminal\fR" 4
 869 .IX Item "--disassembler-color=terminal"
 870 .IP "\fB\-\-disassembler\-color=on|color|colour\fR" 4
 871 .IX Item "--disassembler-color=on|color|colour"
 872 .IP "\fB\-\-disassembler\-color=extened|extended\-color|extened\-colour\fR" 4
 873 .IX Item "--disassembler-color=extened|extended-color|extened-colour"
 874 .PD
 875 Enables or disables the use of colored syntax highlighting in
 876 disassembly output.  The default behaviour is determined via a
 877 configure time option.  Note, not all architectures support colored
 878 syntax highlighting, and depending upon the terminal used, colored
 879 output may not actually be legible.
 880 .Sp
 881 The \fBon\fR argument adds colors using simple terminal colors.
 882 .Sp
 883 The \fBterminal\fR argument does the same, but only if the output
 884 device is a terminal.
 885 .Sp
 886 The \fBextended-color\fR argument is similar to the \fBon\fR
 887 argument, but it uses 8\-bit colors.  These may not work on all
 888 terminals.
 889 .Sp
 890 The \fBoff\fR argument disables colored disassembly.
 891 .IP "\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR" 4
 892 .IX Item "-W[lLiaprmfFsoORtUuTgAckK]"
 893 .PD 0
 894 .IP "\fB\-\-dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=str\-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow\-links]\fR" 4
 895 .IX Item "--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]"
 896 .PD
 897 Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
 898 are present.  Compressed debug sections are automatically decompressed
 899 (temporarily) before they are displayed.  If one or more of the
 900 optional letters or words follows the switch then only those type(s)
 901 of data will be dumped.  The letters and words refer to the following
 902 information:
 903 .RS 4
 904 .ie n .IP """a""" 4
 905 .el .IP "\f(CWa\fR" 4
 906 .IX Item "a"
 907 .PD 0
 908 .ie n .IP """=abbrev""" 4
 909 .el .IP "\f(CW=abbrev\fR" 4
 910 .IX Item "=abbrev"
 911 .PD
 912 Displays the contents of the \fB.debug_abbrev\fR section.
 913 .ie n .IP """A""" 4
 914 .el .IP "\f(CWA\fR" 4
 915 .IX Item "A"
 916 .PD 0
 917 .ie n .IP """=addr""" 4
 918 .el .IP "\f(CW=addr\fR" 4
 919 .IX Item "=addr"
 920 .PD
 921 Displays the contents of the \fB.debug_addr\fR section.
 922 .ie n .IP """c""" 4
 923 .el .IP "\f(CWc\fR" 4
 924 .IX Item "c"
 925 .PD 0
 926 .ie n .IP """=cu_index""" 4
 927 .el .IP "\f(CW=cu_index\fR" 4
 928 .IX Item "=cu_index"
 929 .PD
 930 Displays the contents of the \fB.debug_cu_index\fR and/or
 931 \&\fB.debug_tu_index\fR sections.
 932 .ie n .IP """f""" 4
 933 .el .IP "\f(CWf\fR" 4
 934 .IX Item "f"
 935 .PD 0
 936 .ie n .IP """=frames""" 4
 937 .el .IP "\f(CW=frames\fR" 4
 938 .IX Item "=frames"
 939 .PD
 940 Display the raw contents of a \fB.debug_frame\fR section.
 941 .ie n .IP """F""" 4
 942 .el .IP "\f(CWF\fR" 4
 943 .IX Item "F"
 944 .PD 0
 945 .ie n .IP """=frames\-interp""" 4
 946 .el .IP "\f(CW=frames\-interp\fR" 4
 947 .IX Item "=frames-interp"
 948 .PD
 949 Display the interpreted contents of a \fB.debug_frame\fR section.
 950 .ie n .IP """g""" 4
 951 .el .IP "\f(CWg\fR" 4
 952 .IX Item "g"
 953 .PD 0
 954 .ie n .IP """=gdb_index""" 4
 955 .el .IP "\f(CW=gdb_index\fR" 4
 956 .IX Item "=gdb_index"
 957 .PD
 958 Displays the contents of the \fB.gdb_index\fR and/or
 959 \&\fB.debug_names\fR sections.
 960 .ie n .IP """i""" 4
 961 .el .IP "\f(CWi\fR" 4
 962 .IX Item "i"
 963 .PD 0
 964 .ie n .IP """=info""" 4
 965 .el .IP "\f(CW=info\fR" 4
 966 .IX Item "=info"
 967 .PD
 968 Displays the contents of the \fB.debug_info\fR section.  Note: the
 969 output from this option can also be restricted by the use of the
 970 \&\fB\-\-dwarf\-depth\fR and \fB\-\-dwarf\-start\fR options.
 971 .ie n .IP """k""" 4
 972 .el .IP "\f(CWk\fR" 4
 973 .IX Item "k"
 974 .PD 0
 975 .ie n .IP """=links""" 4
 976 .el .IP "\f(CW=links\fR" 4
 977 .IX Item "=links"
 978 .PD
 979 Displays the contents of the \fB.gnu_debuglink\fR,
 980 \&\fB.gnu_debugaltlink\fR and \fB.debug_sup\fR sections, if any of
 981 them are present.  Also displays any links to separate dwarf object
 982 files (dwo), if they are specified by the DW_AT_GNU_dwo_name or
 983 DW_AT_dwo_name attributes in the \fB.debug_info\fR section.
 984 .ie n .IP """K""" 4
 985 .el .IP "\f(CWK\fR" 4
 986 .IX Item "K"
 987 .PD 0
 988 .ie n .IP """=follow\-links""" 4
 989 .el .IP "\f(CW=follow\-links\fR" 4
 990 .IX Item "=follow-links"
 991 .PD
 992 Display the contents of any selected debug sections that are found in
 993 linked, separate debug info file(s).  This can result in multiple
 994 versions of the same debug section being displayed if it exists in
 995 more than one file.
 996 .Sp
 997 In addition, when displaying \s-1DWARF\s0 attributes, if a form is found that
 998 references the separate debug info file, then the referenced contents
 999 will also be displayed.
1000 .Sp
1001 Note \- in some distributions this option is enabled by default.  It
1002 can be disabled via the \fBN\fR debug option.  The default can be
1003 chosen when configuring the binutils via the
1004 \&\fB\-\-enable\-follow\-debug\-links=yes\fR or
1005 \&\fB\-\-enable\-follow\-debug\-links=no\fR options.  If these are not
1006 used then the default is to enable the following of debug links.
1007 .Sp
1008 Note \- if support for the debuginfod protocol was enabled when the
1009 binutils were built then this option will also include an attempt to
1010 contact any debuginfod servers mentioned in the \fI\s-1DEBUGINFOD_URLS\s0\fR
1011 environment variable.  This could take some time to resolve.  This
1012 behaviour can be disabled via the \fB=do\-not\-use\-debuginfod\fR debug
1013 option.
1014 .ie n .IP """N""" 4
1015 .el .IP "\f(CWN\fR" 4
1016 .IX Item "N"
1017 .PD 0
1018 .ie n .IP """=no\-follow\-links""" 4
1019 .el .IP "\f(CW=no\-follow\-links\fR" 4
1020 .IX Item "=no-follow-links"
1021 .PD
1022 Disables the following of links to separate debug info files.
1023 .ie n .IP """D""" 4
1024 .el .IP "\f(CWD\fR" 4
1025 .IX Item "D"
1026 .PD 0
1027 .ie n .IP """=use\-debuginfod""" 4
1028 .el .IP "\f(CW=use\-debuginfod\fR" 4
1029 .IX Item "=use-debuginfod"
1030 .PD
1031 Enables contacting debuginfod servers if there is a need to follow
1032 debug links.  This is the default behaviour.
1033 .ie n .IP """E""" 4
1034 .el .IP "\f(CWE\fR" 4
1035 .IX Item "E"
1036 .PD 0
1037 .ie n .IP """=do\-not\-use\-debuginfod""" 4
1038 .el .IP "\f(CW=do\-not\-use\-debuginfod\fR" 4
1039 .IX Item "=do-not-use-debuginfod"
1040 .PD
1041 Disables contacting debuginfod servers when there is a need to follow
1042 debug links.
1043 .ie n .IP """l""" 4
1044 .el .IP "\f(CWl\fR" 4
1045 .IX Item "l"
1046 .PD 0
1047 .ie n .IP """=rawline""" 4
1048 .el .IP "\f(CW=rawline\fR" 4
1049 .IX Item "=rawline"
1050 .PD
1051 Displays the contents of the \fB.debug_line\fR section in a raw
1052 format.
1053 .ie n .IP """L""" 4
1054 .el .IP "\f(CWL\fR" 4
1055 .IX Item "L"
1056 .PD 0
1057 .ie n .IP """=decodedline""" 4
1058 .el .IP "\f(CW=decodedline\fR" 4
1059 .IX Item "=decodedline"
1060 .PD
1061 Displays the interpreted contents of the \fB.debug_line\fR section.
1062 .ie n .IP """m""" 4
1063 .el .IP "\f(CWm\fR" 4
1064 .IX Item "m"
1065 .PD 0
1066 .ie n .IP """=macro""" 4
1067 .el .IP "\f(CW=macro\fR" 4
1068 .IX Item "=macro"
1069 .PD
1070 Displays the contents of the \fB.debug_macro\fR and/or
1071 \&\fB.debug_macinfo\fR sections.
1072 .ie n .IP """o""" 4
1073 .el .IP "\f(CWo\fR" 4
1074 .IX Item "o"
1075 .PD 0
1076 .ie n .IP """=loc""" 4
1077 .el .IP "\f(CW=loc\fR" 4
1078 .IX Item "=loc"
1079 .PD
1080 Displays the contents of the \fB.debug_loc\fR and/or
1081 \&\fB.debug_loclists\fR sections.
1082 .ie n .IP """O""" 4
1083 .el .IP "\f(CWO\fR" 4
1084 .IX Item "O"
1085 .PD 0
1086 .ie n .IP """=str\-offsets""" 4
1087 .el .IP "\f(CW=str\-offsets\fR" 4
1088 .IX Item "=str-offsets"
1089 .PD
1090 Displays the contents of the \fB.debug_str_offsets\fR section.
1091 .ie n .IP """p""" 4
1092 .el .IP "\f(CWp\fR" 4
1093 .IX Item "p"
1094 .PD 0
1095 .ie n .IP """=pubnames""" 4
1096 .el .IP "\f(CW=pubnames\fR" 4
1097 .IX Item "=pubnames"
1098 .PD
1099 Displays the contents of the \fB.debug_pubnames\fR and/or
1100 \&\fB.debug_gnu_pubnames\fR sections.
1101 .ie n .IP """r""" 4
1102 .el .IP "\f(CWr\fR" 4
1103 .IX Item "r"
1104 .PD 0
1105 .ie n .IP """=aranges""" 4
1106 .el .IP "\f(CW=aranges\fR" 4
1107 .IX Item "=aranges"
1108 .PD
1109 Displays the contents of the \fB.debug_aranges\fR section.
1110 .ie n .IP """R""" 4
1111 .el .IP "\f(CWR\fR" 4
1112 .IX Item "R"
1113 .PD 0
1114 .ie n .IP """=Ranges""" 4
1115 .el .IP "\f(CW=Ranges\fR" 4
1116 .IX Item "=Ranges"
1117 .PD
1118 Displays the contents of the \fB.debug_ranges\fR and/or
1119 \&\fB.debug_rnglists\fR sections.
1120 .ie n .IP """s""" 4
1121 .el .IP "\f(CWs\fR" 4
1122 .IX Item "s"
1123 .PD 0
1124 .ie n .IP """=str""" 4
1125 .el .IP "\f(CW=str\fR" 4
1126 .IX Item "=str"
1127 .PD
1128 Displays the contents of the \fB.debug_str\fR, \fB.debug_line_str\fR
1129 and/or \fB.debug_str_offsets\fR sections.
1130 .ie n .IP """t""" 4
1131 .el .IP "\f(CWt\fR" 4
1132 .IX Item "t"
1133 .PD 0
1134 .ie n .IP """=pubtype""" 4
1135 .el .IP "\f(CW=pubtype\fR" 4
1136 .IX Item "=pubtype"
1137 .PD
1138 Displays the contents of the \fB.debug_pubtypes\fR and/or
1139 \&\fB.debug_gnu_pubtypes\fR sections.
1140 .ie n .IP """T""" 4
1141 .el .IP "\f(CWT\fR" 4
1142 .IX Item "T"
1143 .PD 0
1144 .ie n .IP """=trace_aranges""" 4
1145 .el .IP "\f(CW=trace_aranges\fR" 4
1146 .IX Item "=trace_aranges"
1147 .PD
1148 Displays the contents of the \fB.trace_aranges\fR section.
1149 .ie n .IP """u""" 4
1150 .el .IP "\f(CWu\fR" 4
1151 .IX Item "u"
1152 .PD 0
1153 .ie n .IP """=trace_abbrev""" 4
1154 .el .IP "\f(CW=trace_abbrev\fR" 4
1155 .IX Item "=trace_abbrev"
1156 .PD
1157 Displays the contents of the \fB.trace_abbrev\fR section.
1158 .ie n .IP """U""" 4
1159 .el .IP "\f(CWU\fR" 4
1160 .IX Item "U"
1161 .PD 0
1162 .ie n .IP """=trace_info""" 4
1163 .el .IP "\f(CW=trace_info\fR" 4
1164 .IX Item "=trace_info"
1165 .PD
1166 Displays the contents of the \fB.trace_info\fR section.
1167 .RE
1168 .RS 4
1169 .Sp
1170 Note: displaying the contents of \fB.debug_static_funcs\fR,
1171 \&\fB.debug_static_vars\fR and \fBdebug_weaknames\fR sections is not
1172 currently supported.
1173 .RE
1174 .IP "\fB\-\-dwarf\-depth=\fR\fIn\fR" 4
1175 .IX Item "--dwarf-depth=n"
1176 Limit the dump of the \f(CW\*(C`.debug_info\*(C'\fR section to \fIn\fR children.
1177 This is only useful with \fB\-\-debug\-dump=info\fR.  The default is
1178 to print all DIEs; the special value 0 for \fIn\fR will also have this
1179 effect.
1180 .Sp
1181 With a non-zero value for \fIn\fR, DIEs at or deeper than \fIn\fR
1182 levels will not be printed.  The range for \fIn\fR is zero-based.
1183 .IP "\fB\-\-dwarf\-start=\fR\fIn\fR" 4
1184 .IX Item "--dwarf-start=n"
1185 Print only DIEs beginning with the \s-1DIE\s0 numbered \fIn\fR.  This is only
1186 useful with \fB\-\-debug\-dump=info\fR.
1187 .Sp
1188 If specified, this option will suppress printing of any header
1189 information and all DIEs before the \s-1DIE\s0 numbered \fIn\fR.  Only
1190 siblings and children of the specified \s-1DIE\s0 will be printed.
1191 .Sp
1192 This can be used in conjunction with \fB\-\-dwarf\-depth\fR.
1193 .IP "\fB\-\-dwarf\-check\fR" 4
1194 .IX Item "--dwarf-check"
1195 Enable additional checks for consistency of Dwarf information.
1196 .IP "\fB\-\-ctf[=\fR\fIsection\fR\fB]\fR" 4
1197 .IX Item "--ctf[=section]"
1198 Display the contents of the specified \s-1CTF\s0 section.  \s-1CTF\s0 sections themselves
1199 contain many subsections, all of which are displayed in order.
1200 .Sp
1201 By default, display the name of the section named \fI.ctf\fR, which is the
1202 name emitted by \fBld\fR.
1203 .IP "\fB\-\-ctf\-parent=\fR\fImember\fR" 4
1204 .IX Item "--ctf-parent=member"
1205 If the \s-1CTF\s0 section contains ambiguously-defined types, it will consist
1206 of an archive of many \s-1CTF\s0 dictionaries, all inheriting from one
1207 dictionary containing unambiguous types.  This member is by default
1208 named \fI.ctf\fR, like the section containing it, but it is possible to
1209 change this name using the \f(CW\*(C`ctf_link_set_memb_name_changer\*(C'\fR
1210 function at link time.  When looking at \s-1CTF\s0 archives that have been
1211 created by a linker that uses the name changer to rename the parent
1212 archive member, \fB\-\-ctf\-parent\fR can be used to specify the name
1213 used for the parent.
1214 .IP "\fB\-\-sframe[=\fR\fIsection\fR\fB]\fR" 4
1215 .IX Item "--sframe[=section]"
1216 Display the contents of the specified SFrame section.
1217 .Sp
1218 By default, display the name of the section named \fI.sframe\fR, which is the
1219 name emitted by \fBld\fR.
1220 .IP "\fB\-G\fR" 4
1221 .IX Item "-G"
1222 .PD 0
1223 .IP "\fB\-\-stabs\fR" 4
1224 .IX Item "--stabs"
1225 .PD
1226 Display the full contents of any sections requested.  Display the
1227 contents of the .stab and .stab.index and .stab.excl sections from an
1228 \&\s-1ELF\s0 file.  This is only useful on systems (such as Solaris 2.0) in which
1229 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
1230 section.  In most other file formats, debugging symbol-table entries are
1231 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
1232 output.
1233 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
1234 .IX Item "--start-address=address"
1235 Start displaying data at the specified address.  This affects the output
1236 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
1237 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
1238 .IX Item "--stop-address=address"
1239 Stop displaying data at the specified address.  This affects the output
1240 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
1241 .IP "\fB\-t\fR" 4
1242 .IX Item "-t"
1243 .PD 0
1244 .IP "\fB\-\-syms\fR" 4
1245 .IX Item "--syms"
1246 .PD
1247 Print the symbol table entries of the file.
1248 This is similar to the information provided by the \fBnm\fR program,
1249 although the display format is different.  The format of the output
1250 depends upon the format of the file being dumped, but there are two main
1251 types.  One looks like this:
1252 .Sp
1253 .Vb 2
1254 \&        [  4](sec  3)(fl 0x00)(ty   0)(scl   3) (nx 1) 0x00000000 .bss
1255 \&        [  6](sec  1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x00000000 fred
1256 .Ve
1257 .Sp
1258 where the number inside the square brackets is the number of the entry
1259 in the symbol table, the \fIsec\fR number is the section number, the
1260 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
1261 symbol's type, the \fIscl\fR number is the symbol's storage class and
1262 the \fInx\fR value is the number of auxiliary entries associated with
1263 the symbol.  The last two fields are the symbol's value and its name.
1264 .Sp
1265 The other common output format, usually seen with \s-1ELF\s0 based files,
1266 looks like this:
1267 .Sp
1268 .Vb 2
1269 \&        00000000 l    d  .bss   00000000 .bss
1270 \&        00000000 g       .text  00000000 fred
1271 .Ve
1272 .Sp
1273 Here the first number is the symbol's value (sometimes referred to as
1274 its address).  The next field is actually a set of characters and
1275 spaces indicating the flag bits that are set on the symbol.  These
1276 characters are described below.  Next is the section with which the
1277 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
1278 not connected with any section), or \fI*UND*\fR if the section is
1279 referenced in the file being dumped, but not defined there.
1280 .Sp
1281 After the section name comes another field, a number, which for common
1282 symbols is the alignment and for other symbol is the size.  Finally
1283 the symbol's name is displayed.
1284 .Sp
1285 The flag characters are divided into 7 groups as follows:
1286 .RS 4
1287 .ie n .IP """l""" 4
1288 .el .IP "\f(CWl\fR" 4
1289 .IX Item "l"
1290 .PD 0
1291 .ie n .IP """g""" 4
1292 .el .IP "\f(CWg\fR" 4
1293 .IX Item "g"
1294 .ie n .IP """u""" 4
1295 .el .IP "\f(CWu\fR" 4
1296 .IX Item "u"
1297 .ie n .IP """!""" 4
1298 .el .IP "\f(CW!\fR" 4
1299 .IX Item "!"
1300 .PD
1301 The symbol is a local (l), global (g), unique global (u), neither
1302 global nor local (a space) or both global and local (!).  A
1303 symbol can be neither local or global for a variety of reasons, e.g.,
1304 because it is used for debugging, but it is probably an indication of
1305 a bug if it is ever both local and global.  Unique global symbols are
1306 a \s-1GNU\s0 extension to the standard set of \s-1ELF\s0 symbol bindings.  For such
1307 a symbol the dynamic linker will make sure that in the entire process
1308 there is just one symbol with this name and type in use.
1309 .ie n .IP """w""" 4
1310 .el .IP "\f(CWw\fR" 4
1311 .IX Item "w"
1312 The symbol is weak (w) or strong (a space).
1313 .ie n .IP """C""" 4
1314 .el .IP "\f(CWC\fR" 4
1315 .IX Item "C"
1316 The symbol denotes a constructor (C) or an ordinary symbol (a space).
1317 .ie n .IP """W""" 4
1318 .el .IP "\f(CWW\fR" 4
1319 .IX Item "W"
1320 The symbol is a warning (W) or a normal symbol (a space).  A warning
1321 symbol's name is a message to be displayed if the symbol following the
1322 warning symbol is ever referenced.
1323 .ie n .IP """I""" 4
1324 .el .IP "\f(CWI\fR" 4
1325 .IX Item "I"
1326 .PD 0
1327 .ie n .IP """i""" 4
1328 .el .IP "\f(CWi\fR" 4
1329 .IX Item "i"
1330 .PD
1331 The symbol is an indirect reference to another symbol (I), a function
1332 to be evaluated during reloc processing (i) or a normal symbol (a
1333 space).
1334 .ie n .IP """d""" 4
1335 .el .IP "\f(CWd\fR" 4
1336 .IX Item "d"
1337 .PD 0
1338 .ie n .IP """D""" 4
1339 .el .IP "\f(CWD\fR" 4
1340 .IX Item "D"
1341 .PD
1342 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
1343 normal symbol (a space).
1344 .ie n .IP """F""" 4
1345 .el .IP "\f(CWF\fR" 4
1346 .IX Item "F"
1347 .PD 0
1348 .ie n .IP """f""" 4
1349 .el .IP "\f(CWf\fR" 4
1350 .IX Item "f"
1351 .ie n .IP """O""" 4
1352 .el .IP "\f(CWO\fR" 4
1353 .IX Item "O"
1354 .PD
1355 The symbol is the name of a function (F) or a file (f) or an object
1356 (O) or just a normal symbol (a space).
1357 .RE
1358 .RS 4
1359 .RE
1360 .IP "\fB\-T\fR" 4
1361 .IX Item "-T"
1362 .PD 0
1363 .IP "\fB\-\-dynamic\-syms\fR" 4
1364 .IX Item "--dynamic-syms"
1365 .PD
1366 Print the dynamic symbol table entries of the file.  This is only
1367 meaningful for dynamic objects, such as certain types of shared
1368 libraries.  This is similar to the information provided by the \fBnm\fR
1369 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
1370 .Sp
1371 The output format is similar to that produced by the \fB\-\-syms\fR
1372 option, except that an extra field is inserted before the symbol's
1373 name, giving the version information associated with the symbol.
1374 If the version is the default version to be used when resolving
1375 unversioned references to the symbol then it's displayed as is,
1376 otherwise it's put into parentheses.
1377 .IP "\fB\-\-special\-syms\fR" 4
1378 .IX Item "--special-syms"
1379 When displaying symbols include those which the target considers to be
1380 special in some way and which would not normally be of interest to the
1381 user.
1382 .IP "\fB\-U\fR \fI[d|i|l|e|x|h]\fR" 4
1383 .IX Item "-U [d|i|l|e|x|h]"
1384 .PD 0
1385 .IP "\fB\-\-unicode=\fR\fI[default|invalid|locale|escape|hex|highlight]\fR" 4
1386 .IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
1387 .PD
1388 Controls the display of \s-1UTF\-8\s0 encoded multibyte characters in strings.
1389 The default (\fB\-\-unicode=default\fR) is to give them no special
1390 treatment.  The \fB\-\-unicode=locale\fR option displays the sequence
1391 in the current locale, which may or may not support them.  The options
1392 \&\fB\-\-unicode=hex\fR and \fB\-\-unicode=invalid\fR display them as
1393 hex byte sequences enclosed by either angle brackets or curly braces.
1394 .Sp
1395 The \fB\-\-unicode=escape\fR option displays them as escape sequences
1396 (\fI\euxxxx\fR) and the \fB\-\-unicode=highlight\fR option displays
1397 them as escape sequences highlighted in red (if supported by the
1398 output device).  The colouring is intended to draw attention to the
1399 presence of unicode sequences where they might not be expected.
1400 .IP "\fB\-V\fR" 4
1401 .IX Item "-V"
1402 .PD 0
1403 .IP "\fB\-\-version\fR" 4
1404 .IX Item "--version"
1405 .PD
1406 Print the version number of \fBobjdump\fR and exit.
1407 .IP "\fB\-x\fR" 4
1408 .IX Item "-x"
1409 .PD 0
1410 .IP "\fB\-\-all\-headers\fR" 4
1411 .IX Item "--all-headers"
1412 .PD
1413 Display all available header information, including the symbol table and
1414 relocation entries.  Using \fB\-x\fR is equivalent to specifying all of
1415 \&\fB\-a \-f \-h \-p \-r \-t\fR.
1416 .IP "\fB\-w\fR" 4
1417 .IX Item "-w"
1418 .PD 0
1419 .IP "\fB\-\-wide\fR" 4
1420 .IX Item "--wide"
1421 .PD
1422 Format some lines for output devices that have more than 80 columns.
1423 Also do not truncate symbol names when they are displayed.
1424 .IP "\fB\-z\fR" 4
1425 .IX Item "-z"
1426 .PD 0
1427 .IP "\fB\-\-disassemble\-zeroes\fR" 4
1428 .IX Item "--disassemble-zeroes"
1429 .PD
1430 Normally the disassembly output will skip blocks of zeroes.  This
1431 option directs the disassembler to disassemble those blocks, just like
1432 any other data.
1433 .IP "\fB@\fR\fIfile\fR" 4
1434 .IX Item "@file"
1435 Read command-line options from \fIfile\fR.  The options read are
1436 inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
1437 does not exist, or cannot be read, then the option will be treated
1438 literally, and not removed.
1439 .Sp
1440 Options in \fIfile\fR are separated by whitespace.  A whitespace
1441 character may be included in an option by surrounding the entire
1442 option in either single or double quotes.  Any character (including a
1443 backslash) may be included by prefixing the character to be included
1444 with a backslash.  The \fIfile\fR may itself contain additional
1445 @\fIfile\fR options; any such options will be processed recursively.
1446 .SH "SEE ALSO"
1447 .IX Header "SEE ALSO"
1448 \&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
1449 .SH "COPYRIGHT"
1450 .IX Header "COPYRIGHT"
1451 Copyright (c) 1991\-2023 Free Software Foundation, Inc.
1452 .PP
1453 Permission is granted to copy, distribute and/or modify this document
1454 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
1455 or any later version published by the Free Software Foundation;
1456 with no Invariant Sections, with no Front-Cover Texts, and with no
1457 Back-Cover Texts.  A copy of the license is included in the
1458 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".