PR17074 - ignore line terminator characters found inside strings.

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

diff --git a/binutils/objdump.1 b/binutils/objdump.1
index 8e292491fa3f02c5794012332578b632912227f1..128664e9e4e30cbc30b432ce91ace5de2cacf7fa 100644 (file)
--- a/binutils/objdump.1
+++ b/binutils/objdump.1
@@ -1,4 +1,4 @@
-.\" Copyright (c) 1991, 1996 Free Software Foundation
+.\" Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation
 .\" See section COPYING for conditions for redistribution
 .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
 .de BP
@@ -21,9 +21,11 @@ objdump \- display information from object files.
 .RB " | " "\-\-target="\c
 .I bfdname\c
 \&\|] 
+.RB "[\|" \-C | \-\-demangle "\|]" 
 .RB "[\|" \-\-debugging "\|]" 
 .RB "[\|" \-d | \-\-disassemble "\|]" 
 .RB "[\|" \-D | \-\-disassemble-all "\|]" 
+.RB "[\|" \-\-disassemble\-zeroes "\|]" 
 .RB "[\|" \-EB | \-EL | \-\-endian=\c
 .I {big|little}\c
 \&\|]
@@ -42,11 +44,13 @@ objdump \- display information from object files.
 .RB " | " "\-\-architecture="\c
 .I machine\c
 \&\|] 
+.RB "[\|" \-p | \-\-private\-headers "\|]" 
+.RB "[\|" \-\-prefix\-addresses "\|]" 
 .RB "[\|" \-r | \-\-reloc "\|]" 
 .RB "[\|" \-R | \-\-dynamic\-reloc "\|]" 
 .RB "[\|" \-s | \-\-full\-contents "\|]"
 .RB "[\|" \-S | \-\-source "\|]"
-.RB "[\|" \-\-show\-raw\-insn "\|]" 
+.RB "[\|" \-\-[no\-]show\-raw\-insn "\|]" 
 .RB "[\|" \-\-stabs "\|]"
 .RB "[\|" \-t | \-\-syms "\|]" 
 .RB "[\|" \-T | \-\-dynamic\-syms "\|]" 
@@ -57,6 +61,9 @@ objdump \- display information from object files.
 .RB "[\|" "\-\-stop\-address="\c
 .I address\c
 \&\|]
+.RB "[\|" "\-\-adjust\-vma="\c
+.I offset\c
+\&\|]
 .RB "[\|" \-\-version "\|]"
 .RB "[\|" \-\-help "\|]"
 .I objfile\c
@@ -101,6 +108,15 @@ information you could list with `\|\c
 \|' shows
 the object file format of each archive member.
 
+.TP
+.BI "\-\-adjust\-vma=" "offset"
+When dumping information, first add
+.I offset
+to all the section addresses.  This is useful if the section addresses
+do not correspond to the symbol table, which can happen when putting
+sections at particular addresses when using a format which can not
+represent section addresses, such as a.out.
+
 .TP
 .BI "\-b " "bfdname"\c
 .TP
@@ -130,6 +146,14 @@ formats available with the `\|\c
 .B \-i\c
 \|' option.
 
+.TP
+.B \-C
+.TP
+.B \-\-demangle
+Decode (\fIdemangle\fP) low-level symbol names into user-level names.
+Besides removing any initial underscore prepended by the system, this
+makes C++ function names readable.
+
 .TP
 .B \-\-debugging
 Display debugging information.  This attempts to parse debugging
@@ -154,6 +178,17 @@ 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
@@ -220,10 +255,18 @@ Only useful with \fB\-d\fP, \fB\-D\fP, or \fB\-r\fP.
 .TP
 .BI "\-\-architecture=" "machine"
 Specify the architecture to use when disassembling object files.  This
-can be useful when disasembling object files which do not describe
+can be useful when disassembling 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 \-p
+.TP
+.B \-\-private\-headers
+Print information that is specific to the object file format.  The
+exact information printed depends upon the object file format.  For
+some object file formats, no additional information is printed.
+
 .TP
 .B \-r
 .TP
@@ -254,9 +297,18 @@ Display source code intermixed with disassembly, if possible.  Implies
 \fB-d\fP.
 
 .TP
-.B \-\-show-raw-insn
+.B \-\-show\-raw\-insn
 When disassembling instructions, print the instruction in hex as well as
-in symbolic form.  Not all targets handle this correctly yet.
+in symbolic form.  This is the default except when
+.B \-\-prefix\-addresses
+is used.
+
+.TP
+.B \-\-no\-show\-raw\-insn
+When disassembling instructions, do not print the instruction bytes.
+This is the default when
+.B \-\-prefix\-addresses
+is used.
 
 .TP
 .B \-\-stabs
@@ -265,7 +317,8 @@ 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.
+.B \-\-syms
+output.
 
 .TP
 .BI "\-\-start\-address=" "address"