* Makefile.in (maintainer-clean): New target.

[deliverable/binutils-gdb.git] / binutils / objdump.1

diff --git a/binutils/objdump.1 b/binutils/objdump.1
index f935e11490ac0ab0a6f2836f3429e04f67ed0326..f5beb3302d4f0e1a21136054026ab7bfc75619cf 100644 (file)
--- a/binutils/objdump.1
+++ b/binutils/objdump.1
@@ -8,33 +8,44 @@
 ..
 
 .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 "\|]" 
+.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 "[\|" \-R | \-\-dynamic\-reloc "\|]" 
+.RB "[\|" \-s | \-\-full\-contents "\|]"
+.RB "[\|" \-S | \-\-source "\|]"
 .RB "[\|" \-\-stabs "\|]"
 .RB "[\|" \-t | \-\-syms "\|]" 
-.RB "[\|" \-x "\|]"
+.RB "[\|" \-T | \-\-dynamic\-syms "\|]" 
+.RB "[\|" \-x | \-\-all\-headers "\|]"
 .RB "[\|" \-\-version "\|]"
 .RB "[\|" \-\-help "\|]"
 .I objfile\c
@@ -60,10 +71,12 @@ are the object files to be examined.  When you specify archives,
 Where long and short forms of an option are shown together, they are
 equivalent.  At least one option besides
 .B \-l
-must be given.
+(\fB\-\-line\-numbers\fP) must be given.
 
 .TP
 .B \-a
+.TP
+.B \-\-archive\-headers
 If any files from \c
 .I objfile\c
 \& are archives, display the archive
@@ -78,7 +91,9 @@ information you could list with `\|\c
 the object file format of each archive member.
 
 .TP
-.BI "-b " "bfdname"\c
+.BI "\-b " "bfdname"\c
+.TP
+.BI "\-\-target=" "bfdname"\c
 \&
 Specify the object-code format for the object files to be
 \c
@@ -108,14 +123,27 @@ formats available with the `\|\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 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 objfile\c
 \&.
@@ -123,8 +151,10 @@ each file in \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
@@ -135,6 +165,8 @@ 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
@@ -143,7 +175,9 @@ for specification with \c
 \&.
 
 .TP
-.BI "-j " "name"\c
+.BI "\-j " "name"\c
+.TP
+.BI "\-\-section=" "name"\c
 \&
 Display information only for section \c
 .I name\c
@@ -151,11 +185,16 @@ Display information only for section \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 objfile\c
@@ -171,12 +210,31 @@ option.
 .B \-r
 .TP
 .B \-\-reloc
-Relocation.  Print the relocation entries of the file.
+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
@@ -195,6 +253,19 @@ 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
@@ -203,6 +274,8 @@ 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