* Makefile.in (@COMMON_MAKEFILE_FRAG@): Use

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

diff --git a/binutils/objdump.1 b/binutils/objdump.1
index 6b73cb9d826aca6686de8b8c28a88b1fef09a663..b74d8256b8f7dfc9b57a5d2ec9e9f1203d9b1c0d 100644 (file)
--- a/binutils/objdump.1
+++ b/binutils/objdump.1
@@ -1,4 +1,4 @@
-.\" Copyright (c) 1991 Free Software Foundation
+.\" Copyright (c) 1991, 1996, 1997 Free Software Foundation
 .\" See section COPYING for conditions for redistribution
 .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
 .de BP
@@ -21,8 +21,13 @@ objdump \- display information from object files.
 .RB " | " "\-\-target="\c
 .I bfdname\c
 \&\|] 
+.RB "[\|" \-\-debugging "\|]" 
 .RB "[\|" \-d | \-\-disassemble "\|]" 
 .RB "[\|" \-D | \-\-disassemble-all "\|]" 
+.RB "[\|" \-\-disassemble\-zeroes "\|]" 
+.RB "[\|" \-EB | \-EL | \-\-endian=\c
+.I {big|little}\c
+\&\|]
 .RB "[\|" \-f | \-\-file\-headers "\|]"
 .RB "[\|" \-h | \-\-section\-headers
 .RB "| " \-\-headers "\|]" 
@@ -38,10 +43,12 @@ objdump \- display information from object files.
 .RB " | " "\-\-architecture="\c
 .I machine\c
 \&\|] 
+.RB "[\|" \-\-prefix\-addresses "\|]" 
 .RB "[\|" \-r | \-\-reloc "\|]" 
 .RB "[\|" \-R | \-\-dynamic\-reloc "\|]" 
 .RB "[\|" \-s | \-\-full\-contents "\|]"
 .RB "[\|" \-S | \-\-source "\|]"
+.RB "[\|" \-\-show\-raw\-insn "\|]" 
 .RB "[\|" \-\-stabs "\|]"
 .RB "[\|" \-t | \-\-syms "\|]" 
 .RB "[\|" \-T | \-\-dynamic\-syms "\|]" 
@@ -99,8 +106,7 @@ the object file format of each archive member.
 .TP
 .BI "\-b " "bfdname"\c
 .TP
-.BI "\-\-target=" "bfdname"\c
-\&
+.BI "\-\-target=" "bfdname"
 Specify the object-code format for the object files to be
 \c
 .I bfdname\c
@@ -113,7 +119,6 @@ automatically recognize many formats.  For example,
 objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
 .br
 .sp
-
 display summary information from the section headers (`\|\c
 .B \-h\c
 \|') of
@@ -127,6 +132,12 @@ formats available with the `\|\c
 .B \-i\c
 \|' option.
 
+.TP
+.B \-\-debugging
+Display debugging information.  This attempts to parse debugging
+information stored in the file and print it out using a C like syntax.
+Only certain types of debugging information have been implemented.
+
 .TP
 .B \-d
 .TP
@@ -145,6 +156,27 @@ expected to contain instructions.
 Like \fB\-d\fP, but disassemble the contents of all sections, not just
 those expected to contain instructions.
 
+.TP
+.B \-\-prefix\-addresses
+When disassembling, print the complete address on each line.  This is
+the older disassembly format.
+
+.TP
+.B \-\-disassemble\-zeroes
+Normally the disassembly output will skip blocks of zeroes.  This
+option directs the disassembler to disassemble those blocks, just like
+any other data.
+
+.TP
+.B \-EB
+.TP
+.B \-EL
+.TP
+.BI "\-\-endian=" "{big|little}"
+Specify the endianness of the object files.  This only affects
+disassembly.  This can be useful when disassembling a file format which
+does not describe endianness information, such as S-records.
+
 .TP
 .B \-f
 .TP
@@ -183,11 +215,10 @@ for specification with \c
 .TP
 .BI "\-j " "name"\c
 .TP
-.BI "\-\-section=" "name"\c
-\&
+.BI "\-\-section=" "name"
 Display information only for section \c
 .I name\c
-\&
+\&.
 
 .TP
 .B \-l
@@ -195,22 +226,16 @@ Display information only for section \c
 .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.
+Only useful with \fB\-d\fP, \fB\-D\fP, or \fB\-r\fP.
 
 .TP
 .BI "\-m " "machine"\c
 .TP
-.BI "\-\-architecture=" "machine"\c
-\&
-Specify the object files \c
-.I objfile\c
-\& are for architecture
-\c
-.I machine\c
-\&.  You can list available architectures using the `\|\c
-.B \-i\c
-\|'
-option. 
+.BI "\-\-architecture=" "machine"
+Specify the architecture to use when disassembling object files.  This
+can be useful when disasembling object files which do not describe
+architecture information, such as S-records.  You can list the available
+architectures with the \fB\-i\fP option. 
 
 .TP
 .B \-r
@@ -241,6 +266,13 @@ Display the full contents of any sections requested.
 Display source code intermixed with disassembly, if possible.  Implies
 \fB-d\fP.
 
+.TP
+.B \-\-show\-raw\-insn
+When disassembling instructions, print the instruction in hex as well as
+in symbolic form.  This is the default except when
+.B \-\-prefix\-addresses
+is used.
+
 .TP
 .B \-\-stabs
 Display the contents of the .stab, .stab.index, and .stab.excl
@@ -324,7 +356,7 @@ The GNU Binary Utilities\c
 .BR nm "(" 1 ")."
 
 .SH COPYING
-Copyright (c) 1991 Free Software Foundation, Inc.
+Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.
 .PP
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice