From c5f0c9388ac2473a9ae5b20ce4d4426b1538f732 Mon Sep 17 00:00:00 2001 From: John Gilmore Date: Thu, 11 Jun 1992 09:18:44 +0000 Subject: [PATCH] * objdump.1, binutils.texi: Update for --stabs. Also fix objdump's doc to use -- rather than + for long options. (FIXME: Not yet fixed everywhere in binutils.texinfo.) --- binutils/ChangeLog | 3 +++ binutils/binutils.texi | 33 +++++++++++++++++++++++---------- binutils/objdump.1 | 22 ++++++++++++++++------ 3 files changed, 42 insertions(+), 16 deletions(-) diff --git a/binutils/ChangeLog b/binutils/ChangeLog index f2c7398f46b..8b076b8b243 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -4,6 +4,9 @@ Thu Jun 11 01:19:06 1992 John Gilmore (gnu at cygnus.com) .stab section from an ELF file. Installed under #ifdef ELF_STAB_DISPLAY so it can be easily disabled, since it requires bfd-internals header files and such. + * objdump.1, binutils.texi: Update for --stabs. Also fix + objdump's doc to use -- rather than + for long options. + (FIXME: Not yet fixed everywhere in binutils.texinfo.) Wed Jun 10 07:53:24 1992 Steve Chamberlain (sac@thepub.cygnus.com) diff --git a/binutils/binutils.texi b/binutils/binutils.texi index b75fb811e95..2ae674a19f5 100644 --- a/binutils/binutils.texi +++ b/binutils/binutils.texi @@ -637,9 +637,9 @@ Display only undefined symbols (those external to each object file). @smallexample objdump [ -a ] [ -b @var{bfdname} ] [ -d ] [ -f ] - [ -h | +header ] [ -i ] [ -j @var{section} ] [ -l ] - [ -m @var{machine} ] [ -r | +reloc ] [ -s ] - [ -t | +syms ] [ -x ] + [ -h | --header ] [ -i ] [ -j @var{section} ] [ -l ] + [ -m @var{machine} ] [ -r | --reloc ] [ -s ] + [ --stabs ] [ -t | --syms ] [ -x ] @var{objfiles}@dots{} @end smallexample @@ -665,7 +665,7 @@ header information (in a format similar to @samp{ls -l}). Besides the information you could list with @samp{ar tv}, @samp{objdump -a} shows the object file format of each archive member. -@c suggest longname +target or +format or +bfd +@c suggest longname --target or --format or --bfd @item -b @var{bfdname} @cindex object code format You can specify a particular object-code format for your object files as @@ -692,7 +692,7 @@ File header. Display summary information from the overall header of each file in @var{objfiles}. @item -h -@itemx +header +@itemx --header @cindex section headers Header. Display summary information from the section headers of the object file. @@ -703,18 +703,18 @@ object file. Display a list showing all architectures and object formats available for specification with @code{-b} or @code{-m}. -@c suggest longname +section +@c suggest longname --section @item -j @var{name} @cindex section information Display information only for section @var{name} -@c suggest longname +label or +linespec +@c suggest longname --label or --linespec @item -l @cindex source filenames for object files Label the display (using debugging information) with the source filename and line numbers corresponding to the object code shown. -@c suggest longname +architecture +@c suggest longname --architecture @item -m @var{machine} @cindex architecture Specify the object files @var{objfiles} are for architecture @@ -722,7 +722,7 @@ Specify the object files @var{objfiles} are for architecture option. @item -r -@itemx +reloc +@itemx --reloc @cindex relocation entries, in object file Relocation. Print the relocation entries of the file. @@ -731,8 +731,21 @@ Relocation. Print the relocation entries of the file. @cindex object file sections Display the full contents of any sections requested. +@item --stabs +@cindex stab +@cindex .stab +@cindex debug symbols +@cindex ELF object file format +Display the full contents of any sections requested. +Display the contents of the .stab section from an ELF file. +This is only useful on systems (such as Solaris 2.0) in which +@code{.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 @samp{--syms} +output. + @item -t -@itemx +syms +@itemx --syms @cindex symbol table entries, printing Symbol Table. Print the symbol table entries of the file. This is similar to the information provided by the @samp{nm} program. diff --git a/binutils/objdump.1 b/binutils/objdump.1 index 63d167881c3..7344fa2b0a9 100644 --- a/binutils/objdump.1 +++ b/binutils/objdump.1 @@ -22,7 +22,7 @@ objdump\(em\&display information from object files. \&\|] .RB "[\|" \-d "\|]" .RB "[\|" \-f "\|]" -.RB "[\|" \-h | +header "\|]" +.RB "[\|" \-h | --header "\|]" .RB "[\|" \-i "\|]" .RB "[\|" "\-j\ "\c .I section\c @@ -31,9 +31,10 @@ objdump\(em\&display information from object files. .RB "[\|" "\-m\ "\c .I machine\c \&\|] -.RB "[\|" \-r | +reloc "\|]" +.RB "[\|" \-r | --reloc "\|]" .RB "[\|" \-s "\|]" -.RB "[\|" \-t | +syms "\|]" +.RB "[\|" \--stabs "\|]" +.RB "[\|" \-t | --syms "\|]" .RB "[\|" \-x "\|]" .I objfiles\c \&.\|.\|. @@ -119,7 +120,7 @@ each file in \c .TP .B \-h .TP -.B +header +.B --header Header. Display summary information from the section headers of the object file. @@ -160,17 +161,26 @@ option. .TP .B \-r .TP -.B +reloc +.B --reloc Relocation. Print the relocation entries of the file. .TP .B \-s Display the full contents of any sections requested. +.TP +.B \--stabs +Display the contents of the .stab section 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 -- 2.30.2