binutils/objdump.1

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