binutils/objdump.1

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