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