.\" Copyright (c) 1991 Free Software Foundation
.\" See section COPYING for conditions for redistribution
-.\" $Id$
.TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
.de BP
.sp
..
.SH NAME
-objdump\(em\&display information from object files.
+objdump \- display information from object files.
.SH SYNOPSIS
.hy 0
.na
.TP
-.B objdump
-.RB "[\|" \-a "\|]"
+.B objdump
+.RB "[\|" \-a | \-\-archive\-headers "\|]"
.RB "[\|" "\-b\ "\c
.I bfdname\c
+.RB " | " "\-\-target="\c
+.I bfdname\c
\&\|]
-.RB "[\|" \-d "\|]"
-.RB "[\|" \-f "\|]"
-.RB "[\|" \-h | +header "\|]"
-.RB "[\|" \-i "\|]"
+.RB "[\|" \-d | \-\-disassemble "\|]"
+.RB "[\|" \-D | \-\-disassemble-all "\|]"
+.RB "[\|" \-f | \-\-file\-headers "\|]"
+.RB "[\|" \-h | \-\-section\-headers
+.RB "| " \-\-headers "\|]"
+.RB "[\|" \-i | \-\-info "\|]"
.RB "[\|" "\-j\ "\c
.I section\c
+.RB " | " "\-\-section="\c
+.I section\c
\&\|]
-.RB "[\|" \-l "\|]"
+.RB "[\|" \-l | \-\-line\-numbers "\|]"
.RB "[\|" "\-m\ "\c
.I machine\c
+.RB " | " "\-\-architecture="\c
+.I machine\c
\&\|]
-.RB "[\|" \-r | +reloc "\|]"
-.RB "[\|" \-s "\|]"
-.RB "[\|" \-t | +syms "\|]"
-.RB "[\|" \-x "\|]"
-.I objfiles\c
+.RB "[\|" \-r | \-\-reloc "\|]"
+.RB "[\|" \-R | \-\-dynamic\-reloc "\|]"
+.RB "[\|" \-s | \-\-full\-contents "\|]"
+.RB "[\|" \-S | \-\-source "\|]"
+.RB "[\|" \-\-stabs "\|]"
+.RB "[\|" \-t | \-\-syms "\|]"
+.RB "[\|" \-T | \-\-dynamic\-syms "\|]"
+.RB "[\|" \-x | \-\-all\-headers "\|]"
+.RB "[\|" \-\-version "\|]"
+.RB "[\|" \-\-help "\|]"
+.I objfile\c
\&.\|.\|.
.ad b
.hy 1
information is mostly useful to programmers who are working on the
compilation tools, as opposed to programmers who just want their
program to compile and work.
-.SH OPTIONS
-Where long and short forms of an option are shown together, they are
-equivalent.
-
-.TP
-.IR "objfiles" .\|.\|.
-The object files to be examined. When you specify archives,
+.PP
+.IR "objfile" .\|.\|.
+are the object files to be examined. When you specify archives,
\c
.B objdump\c
\& shows information on each of the member object files.
+.SH OPTIONS
+Where long and short forms of an option are shown together, they are
+equivalent. At least one option besides
+.B \-l
+(\fB\-\-line\-numbers\fP) must be given.
+
.TP
.B \-a
+.TP
+.B \-\-archive\-headers
If any files from \c
-.I objfiles\c
+.I objfile\c
\& are archives, display the archive
header information (in a format similar to `\|\c
.B ls \-l\c
the object file format of each archive member.
.TP
-.BI "-b " "bfdname"\c
+.BI "\-b " "bfdname"\c
+.TP
+.BI "\-\-target=" "bfdname"\c
\&
-You can specify a particular object-code format for your object files as
+Specify the object-code format for the object files to be
\c
.I bfdname\c
\&. This may not be necessary; \c
.br
.sp
-Displays summary information from the section headers (`\|\c
+display summary information from the section headers (`\|\c
.B \-h\c
\|') of
`\|\c
.TP
.B \-d
-Disassemble. Display the assembler mnemonics for the machine
+.TP
+.B \-\-disassemble
+Display the assembler mnemonics for the machine
instructions from \c
-.I objfiles\c
+.I objfile\c
\&.
+This option only disassembles those sections which are
+expected to contain instructions.
+
+.TP
+.B \-D
+.TP
+.B \-\-disassemble-all
+Like \fB\-d\fP, but disassemble the contents of all sections, not just
+those expected to contain instructions.
.TP
.B \-f
-File header. Display summary information from the overall header of
+.TP
+.B \-\-file\-headers
+Display summary information from the overall header of
each file in \c
-.I objfiles\c
+.I objfile\c
\&.
.TP
.B \-h
.TP
-.B +header
-Header. Display summary information from the section headers of the
+.B \-\-section\-headers
+.TP
+.B \-\-headers
+Display summary information from the section headers of the
object file.
+.TP
+.B \-\-help
+Print a summary of the options to
+.B objdump
+and exit.
+
.TP
.B \-i
+.TP
+.B \-\-info
Display a list showing all architectures and object formats available
for specification with \c
.B \-b\c
\&.
.TP
-.BI "-j " "name"\c
+.BI "\-j " "name"\c
+.TP
+.BI "\-\-section=" "name"\c
\&
Display information only for section \c
.I name\c
.TP
.B \-l
-Label the display (using debugging information) with the source filename
-and line numbers corresponding to the object code shown.
+.TP
+.B \-\-line\-numbers
+Label the display (using debugging information) with the filename
+and source line numbers corresponding to the object code shown.
+Only useful with \fB\-d\fP or \fB\-D\fP.
.TP
-.BI "-m " "machine"\c
+.BI "\-m " "machine"\c
+.TP
+.BI "\-\-architecture=" "machine"\c
\&
Specify the object files \c
-.I objfiles\c
+.I objfile\c
\& are for architecture
\c
.I machine\c
.TP
.B \-r
.TP
-.B +reloc
-Relocation. Print the relocation entries of the file.
+.B \-\-reloc
+Print the relocation entries of the file. If used with \fB\-d\fP or
+\fB\-d\fP, the relocations are printed interspersed with the
+disassembly.
+
+.TP
+.B \-R
+.TP
+.B \-\-dynamic\-reloc
+Print the dynamic relocation entries of the file. This is only
+meaningful for dynamic objects, such as certain types of shared
+libraries.
.TP
.B \-s
+.TP
+.B \-\-full\-contents
Display the full contents of any sections requested.
+.TP
+.B \-S
+.TP
+.B \-\-source
+Display source code intermixed with disassembly, if possible. Implies
+\fB-d\fP.
+
+.TP
+.B \-\-stabs
+Display the contents of the .stab, .stab.index, and .stab.excl
+sections from an ELF file. This is only useful on systems (such as
+Solaris 2.0) in which .stab debugging symbol-table entries are carried
+in an ELF section. In most other file formats, debugging symbol-table
+entries are interleaved with linkage symbols, and are visible in the
+\-\-syms output.
+
.TP
.B \-t
.TP
-.B +syms
+.B \-\-syms
Symbol Table. Print the symbol table entries of the file.
This is similar to the information provided by the `\|\c
.B nm\c
\|' program.
+.TP
+.B \-T
+.TP
+.B \-\-dynamic\-syms
+Dynamic Symbol Table. Print the dynamic symbol table entries of the
+file. This is only meaningful for dynamic objects, such as certain
+types of shared libraries. This is similar to the information
+provided by the `\|\c
+.B nm\c
+\|' program when given the
+.B \-D (\-\-dynamic)
+option.
+
+.TP
+.B \-\-version
+Print the version number of
+.B objdump
+and exit.
+
.TP
.B \-x
+.TP
+.B \-\-all\-headers
Display all available header information, including the symbol table and
relocation entries. Using `\|\c
.B \-x\c
.B \-a \-f \-h \-r \-t\c
\|'.
-.PP
-
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
entry in
projects / deliverable / binutils-gdb.git / blobdiff