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