@ifinfo
@format
START-INFO-DIR-ENTRY
-
-* Binutils: (binutils).
- The GNU binary utilities "ar", "ld", "objdump", "nm",
- "size", "strip", and "ranlib".
-
+* Binutils: (binutils). The GNU binary utilities "ar", "ld", "objdump",
+ "nm", "size", "strip", and "ranlib".
END-INFO-DIR-ENTRY
@end format
@end ifinfo
+@ifinfo
+Copyright @copyright{} 1991 Free Software Foundation, Inc.
+
+Permission is granted to make and distribute verbatim copies of
+this manual provided the copyright notice and this permission notice
+are preserved on all copies.
+
+@ignore
+Permission is granted to process this file through TeX and print the
+results, provided the printed document carries a copying permission
+notice identical to this one except for the removal of this paragraph
+(this paragraph not being relevant to the printed manual).
+
+@end ignore
+
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided also that
+the entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+
+Permission is granted to copy and distribute translations of this manual
+into another language, under the above conditions for modified versions.
+@end ifinfo
+
@synindex ky cp
@c
@c This file documents the GNU binary utilities "ar", "ld", "objdump", "nm",
@c This text may be freely distributed under the terms of the GNU
@c General Public License.
@c
-@c $Id$
-@iftex
-@finalout
-@c @smallbook
-@end iftex
-@c @cropmarks
+
@setchapternewpage odd
@settitle GNU Binary Utilities
@titlepage
+@finalout
+@c @smallbook
+@c @cropmarks
@title The GNU Binary Utilities
-@subtitle Version 1.90
+@subtitle Version 1.97
@sp 1
@subtitle October 1991
@author Roland H. Pesch
@cindex version
This brief manual contains preliminary documentation for the GNU binary
-utilities (collectively version 1.90):
+utilities (collectively version 1.97):
+
+@iftex
@table @code
@item ar
Create, modify, and extract from archives
@item strip
Discard symbols
@end table
-
-@ifinfo
-Copyright @copyright{} 1991 Free Software Foundation, Inc.
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries a copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
-
-@end ignore
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that
-the entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
-@end ifinfo
+@end iftex
@menu
-* ar:: ar
-* ld:: ld
-* nm:: nm
-* objdump:: objdump
-* ranlib:: ranlib
-* size:: size
-* strip:: strip
-* Index:: Index
-
- --- The Detailed Node Listing ---
-
-ar
-
-* ar-cmdline:: Controlling @code{ar} on the command line
-* ar-scripts:: Controlling @code{ar} with a script
+* ar:: Create, modify, and extract from archives
+* ld:(ld)Overview. Combine object and archive files
+* nm:: List symbols from object files
+* objdump:: Display information from object files
+* ranlib:: Generate index to archive contents
+* size:: List section sizes and total size
+* strip:: Discard symbols
+* Index::
@end menu
-@node ar, ld, Top, Top
+@node ar, nm, Top, Top
@chapter ar
@kindex ar
@end table
-
-@node ld, nm, ar, Top
+@iftex
+@node ld
@chapter ld
@cindex linker
@kindex ld
The GNU linker @code{ld} is now described in a separate manual.
-@xref{Top,, Overview,, GLD: the GNU linker}.
+@xref{Top,, Overview,, Using LD: the GNU linker}.
+@end iftex
-@node nm, objdump, ld, Top
+@node nm, objdump, ar, Top
@chapter nm
@cindex symbols
@kindex nm
@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
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
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.
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
option.
@item -r
-@itemx +reloc
+@itemx --reloc
@cindex relocation entries, in object file
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 and .stab.index and .stab.excl sections 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.
projects / binutils.git / blobdiff