binutils/objdump.1

   1 .\" Copyright (c) 1991, 1996, 1997 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
   4 .de BP
   5 .sp
   6 .ti \-.2i
   7 \(**
   8 ..
   9
  10 .SH NAME
  11 objdump \- display information from object files.
  12
  13 .SH SYNOPSIS
  14 .hy 0
  15 .na
  16 .TP
  17 .B objdump
  18 .RB "[\|" \-a | \-\-archive\-headers "\|]"
  19 .RB "[\|" "\-b\ "\c
  20 .I bfdname\c
  21 .RB " | " "\-\-target="\c
  22 .I bfdname\c
  23 \&\|]
  24 .RB "[\|" \-C | \-\-demangle "\|]"
  25 .RB "[\|" \-\-debugging "\|]"
  26 .RB "[\|" \-d | \-\-disassemble "\|]"
  27 .RB "[\|" \-D | \-\-disassemble-all "\|]"
  28 .RB "[\|" \-\-disassemble\-zeroes "\|]"
  29 .RB "[\|" \-EB | \-EL | \-\-endian=\c
  30 .I {big|little}\c
  31 \&\|]
  32 .RB "[\|" \-f | \-\-file\-headers "\|]"
  33 .RB "[\|" \-h | \-\-section\-headers
  34 .RB "| " \-\-headers "\|]"
  35 .RB "[\|" \-i | \-\-info "\|]"
  36 .RB "[\|" "\-j\ "\c
  37 .I section\c
  38 .RB " | " "\-\-section="\c
  39 .I section\c
  40 \&\|]
  41 .RB "[\|" \-l | \-\-line\-numbers "\|]"
  42 .RB "[\|" "\-m\ "\c
  43 .I machine\c
  44 .RB " | " "\-\-architecture="\c
  45 .I machine\c
  46 \&\|]
  47 .RB "[\|" \-\-prefix\-addresses "\|]"
  48 .RB "[\|" \-r | \-\-reloc "\|]"
  49 .RB "[\|" \-R | \-\-dynamic\-reloc "\|]"
  50 .RB "[\|" \-s | \-\-full\-contents "\|]"
  51 .RB "[\|" \-S | \-\-source "\|]"
  52 .RB "[\|" \-\-[no\-]show\-raw\-insn "\|]"
  53 .RB "[\|" \-\-stabs "\|]"
  54 .RB "[\|" \-t | \-\-syms "\|]"
  55 .RB "[\|" \-T | \-\-dynamic\-syms "\|]"
  56 .RB "[\|" \-x | \-\-all\-headers "\|]"
  57 .RB "[\|" "\-\-start\-address="\c
  58 .I address\c
  59 \&\|]
  60 .RB "[\|" "\-\-stop\-address="\c
  61 .I address\c
  62 \&\|]
  63 .RB "[\|" "\-\-adjust\-vma="\c
  64 .I offset\c
  65 \&\|]
  66 .RB "[\|" \-\-version "\|]"
  67 .RB "[\|" \-\-help "\|]"
  68 .I objfile\c
  69 \&.\|.\|.
  70 .ad b
  71 .hy 1
  72 .SH DESCRIPTION
  73 \c
  74 .B objdump\c
  75 \& displays information about one or more object files.
  76 The options control what particular information to display.  This
  77 information is mostly useful to programmers who are working on the
  78 compilation tools, as opposed to programmers who just want their
  79 program to compile and work.
  80 .PP
  81 .IR  "objfile" .\|.\|.
  82 are the object files to be examined.  When you specify archives,
  83 \c
  84 .B objdump\c
  85 \& shows information on each of the member object files.
  86
  87 .SH OPTIONS
  88 Where long and short forms of an option are shown together, they are
  89 equivalent.  At least one option besides
  90 .B \-l
  91 (\fB\-\-line\-numbers\fP) must be given.
  92
  93 .TP
  94 .B \-a
  95 .TP
  96 .B \-\-archive\-headers
  97 If any files from \c
  98 .I objfile\c
  99 \& are archives, display the archive
 100 header information (in a format similar to `\|\c
 101 .B ls \-l\c
 102 \|').  Besides the
 103 information you could list with `\|\c
 104 .B ar tv\c
 105 \|', `\|\c
 106 .B objdump \-a\c
 107 \|' shows
 108 the object file format of each archive member.
 109
 110 .TP
 111 .BI "\-\-adjust\-vma=" "offset"
 112 When dumping information, first add
 113 .I offset
 114 to all the section addresses.  This is useful if the section addresses
 115 do not correspond to the symbol table, which can happen when putting
 116 sections at particular addresses when using a format which can not
 117 represent section addresses, such as a.out.
 118
 119 .TP
 120 .BI "\-b " "bfdname"\c
 121 .TP
 122 .BI "\-\-target=" "bfdname"
 123 Specify the object-code format for the object files to be
 124 \c
 125 .I bfdname\c
 126 \&.  This may not be necessary; \c
 127 .I objdump\c
 128 \& can
 129 automatically recognize many formats.  For example,
 130 .sp
 131 .br
 132 objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
 133 .br
 134 .sp
 135 display summary information from the section headers (`\|\c
 136 .B \-h\c
 137 \|') of
 138 `\|\c
 139 .B fu.o\c
 140 \|', which is explicitly identified (`\|\c
 141 .B \-m\c
 142 \|') as a Vax object
 143 file in the format produced by Oasys compilers.  You can list the
 144 formats available with the `\|\c
 145 .B \-i\c
 146 \|' option.
 147
 148 .TP
 149 .B \-C
 150 .TP
 151 .B \-\-demangle
 152 Decode (\fIdemangle\fP) low-level symbol names into user-level names.
 153 Besides removing any initial underscore prepended by the system, this
 154 makes C++ function names readable.
 155
 156 .TP
 157 .B \-\-debugging
 158 Display debugging information.  This attempts to parse debugging
 159 information stored in the file and print it out using a C like syntax.
 160 Only certain types of debugging information have been implemented.
 161
 162 .TP
 163 .B \-d
 164 .TP
 165 .B \-\-disassemble
 166 Display the assembler mnemonics for the machine
 167 instructions from \c
 168 .I objfile\c
 169 \&.
 170 This option only disassembles those sections which are
 171 expected to contain instructions.
 172
 173 .TP
 174 .B \-D
 175 .TP
 176 .B \-\-disassemble-all
 177 Like \fB\-d\fP, but disassemble the contents of all sections, not just
 178 those expected to contain instructions.
 179
 180 .TP
 181 .B \-\-prefix\-addresses
 182 When disassembling, print the complete address on each line.  This is
 183 the older disassembly format.
 184
 185 .TP
 186 .B \-\-disassemble\-zeroes
 187 Normally the disassembly output will skip blocks of zeroes.  This
 188 option directs the disassembler to disassemble those blocks, just like
 189 any other data.
 190
 191 .TP
 192 .B \-EB
 193 .TP
 194 .B \-EL
 195 .TP
 196 .BI "\-\-endian=" "{big|little}"
 197 Specify the endianness of the object files.  This only affects
 198 disassembly.  This can be useful when disassembling a file format which
 199 does not describe endianness information, such as S-records.
 200
 201 .TP
 202 .B \-f
 203 .TP
 204 .B \-\-file\-headers
 205 Display summary information from the overall header of
 206 each file in \c
 207 .I objfile\c
 208 \&.
 209
 210 .TP
 211 .B \-h
 212 .TP
 213 .B \-\-section\-headers
 214 .TP
 215 .B \-\-headers
 216 Display summary information from the section headers of the
 217 object file.
 218
 219 .TP
 220 .B \-\-help
 221 Print a summary of the options to
 222 .B objdump
 223 and exit.
 224
 225 .TP
 226 .B \-i
 227 .TP
 228 .B \-\-info
 229 Display a list showing all architectures and object formats available
 230 for specification with \c
 231 .B \-b\c
 232 \& or \c
 233 .B \-m\c
 234 \&.
 235
 236 .TP
 237 .BI "\-j " "name"\c
 238 .TP
 239 .BI "\-\-section=" "name"
 240 Display information only for section \c
 241 .I name\c
 242 \&.
 243
 244 .TP
 245 .B \-l
 246 .TP
 247 .B \-\-line\-numbers
 248 Label the display (using debugging information) with the filename
 249 and source line numbers corresponding to the object code shown.
 250 Only useful with \fB\-d\fP, \fB\-D\fP, or \fB\-r\fP.
 251
 252 .TP
 253 .BI "\-m " "machine"\c
 254 .TP
 255 .BI "\-\-architecture=" "machine"
 256 Specify the architecture to use when disassembling object files.  This
 257 can be useful when disasembling object files which do not describe
 258 architecture information, such as S-records.  You can list the available
 259 architectures with the \fB\-i\fP option.
 260
 261 .TP
 262 .B \-r
 263 .TP
 264 .B \-\-reloc
 265 Print the relocation entries of the file.  If used with \fB\-d\fP or
 266 \fB\-d\fP, the relocations are printed interspersed with the
 267 disassembly.
 268
 269 .TP
 270 .B \-R
 271 .TP
 272 .B \-\-dynamic\-reloc
 273 Print the dynamic relocation entries of the file.  This is only
 274 meaningful for dynamic objects, such as certain types of shared
 275 libraries.
 276
 277 .TP
 278 .B \-s
 279 .TP
 280 .B \-\-full\-contents
 281 Display the full contents of any sections requested.
 282
 283 .TP
 284 .B \-S
 285 .TP
 286 .B \-\-source
 287 Display source code intermixed with disassembly, if possible.  Implies
 288 \fB-d\fP.
 289
 290 .TP
 291 .B \-\-show\-raw\-insn
 292 When disassembling instructions, print the instruction in hex as well as
 293 in symbolic form.  This is the default except when
 294 .B \-\-prefix\-addresses
 295 is used.
 296
 297 .TP
 298 .B \-\-no\-show\-raw\-insn
 299 When disassembling instructions, do not print the instruction bytes.
 300 This is the default when
 301 .B \-\-prefix\-addresses
 302 is used.
 303
 304 .TP
 305 .B \-\-stabs
 306 Display the contents of the .stab, .stab.index, and .stab.excl
 307 sections from an ELF file.  This is only useful on systems (such as
 308 Solaris 2.0) in which .stab debugging symbol-table entries are carried
 309 in an ELF section.  In most other file formats, debugging symbol-table
 310 entries are interleaved with linkage symbols, and are visible in the
 311 \-\-syms output.
 312
 313 .TP
 314 .BI "\-\-start\-address=" "address"
 315 Start displaying data at the specified address.  This affects the output
 316 of the
 317 .B \-d\c
 318 ,
 319 .B \-r
 320 and
 321 .B \-s
 322 options.
 323
 324 .TP
 325 .BI "\-\-stop\-address=" "address"
 326 Stop displaying data at the specified address.  This affects the output
 327 of the
 328 .B \-d\c
 329 ,
 330 .B \-r
 331 and
 332 .B \-s
 333 options.
 334
 335 .TP
 336 .B \-t
 337 .TP
 338 .B \-\-syms
 339 Symbol Table.  Print the symbol table entries of the file.
 340 This is similar to the information provided by the `\|\c
 341 .B nm\c
 342 \|' program.
 343
 344 .TP
 345 .B \-T
 346 .TP
 347 .B \-\-dynamic\-syms
 348 Dynamic Symbol Table.  Print the dynamic symbol table entries of the
 349 file.  This is only meaningful for dynamic objects, such as certain
 350 types of shared libraries.  This is similar to the information
 351 provided by the `\|\c
 352 .B nm\c
 353 \|' program when given the
 354 .B \-D (\-\-dynamic)
 355 option.
 356
 357 .TP
 358 .B \-\-version
 359 Print the version number of
 360 .B objdump
 361 and exit.
 362
 363 .TP
 364 .B \-x
 365 .TP
 366 .B \-\-all\-headers
 367 Display all available header information, including the symbol table and
 368 relocation entries.  Using `\|\c
 369 .B \-x\c
 370 \|' is equivalent to specifying all of
 371 `\|\c
 372 .B \-a \-f \-h \-r \-t\c
 373 \|'.
 374
 375 .SH "SEE ALSO"
 376 .RB "`\|" binutils "\|'"
 377 entry in
 378 .B
 379 info\c
 380 \&;
 381 .I
 382 The GNU Binary Utilities\c
 383 \&, Roland H. Pesch (October 1991);
 384 .BR nm "(" 1 ")."
 385
 386 .SH COPYING
 387 Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.
 388 .PP
 389 Permission is granted to make and distribute verbatim copies of
 390 this manual provided the copyright notice and this permission notice
 391 are preserved on all copies.
 392 .PP
 393 Permission is granted to copy and distribute modified versions of this
 394 manual under the conditions for verbatim copying, provided that the
 395 entire resulting derived work is distributed under the terms of a
 396 permission notice identical to this one.
 397 .PP
 398 Permission is granted to copy and distribute translations of this
 399 manual into another language, under the above conditions for modified
 400 versions, except that this permission notice may be included in
 401 translations approved by the Free Software Foundation instead of in
 402 the original English.