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