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