binutils/objdump.1

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