--- a/binutils/doc/binutils.texi 2013-03-25 09:06:21.000000000 +0100 +++ b/binutils/doc/binutils.texi 2013-05-14 20:16:23.000000000 +0200 @@ -12,7 +12,7 @@ @c man begin COPYRIGHT Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, -2010, 2011, 2012 +2010, 2011, 2012, 2013 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document @@ -131,7 +131,7 @@ Manipulate Windows resources @item windmc -Genertor for Windows message resources +Generator for Windows message resources @item dlltool Create the files needed to build and use Dynamic Link Libraries @@ -148,18 +148,18 @@ * objcopy:: Copy and translate object files * objdump:: Display information from object files * ranlib:: Generate index to archive contents -* readelf:: Display the contents of ELF format files * size:: List section sizes and total size * strings:: List printable strings from files * strip:: Discard symbols -* elfedit:: Update the ELF header of ELF files * c++filt:: Filter to demangle encoded C++ symbols * cxxfilt: c++filt. MS-DOS name for c++filt * addr2line:: Convert addresses to file and line * nlmconv:: Converts object code into an NLM -* windres:: Manipulate Windows resources * windmc:: Generator for Windows message resources +* windres:: Manipulate Windows resources * dlltool:: Create files needed to build and use DLLs +* readelf:: Display the contents of ELF format files +* elfedit:: Update the ELF header of ELF files * Common Options:: Command-line options for all utilities * Selecting the Target System:: How these utilities determine the target * Reporting Bugs:: Reporting Bugs @@ -723,17 +723,19 @@ @smallexample @c man begin SYNOPSIS nm -nm [@option{-a}|@option{--debug-syms}] - [@option{-g}|@option{--extern-only}][@option{--plugin} @var{name}] - [@option{-B}] [@option{-C}|@option{--demangle}[=@var{style}]] [@option{-D}|@option{--dynamic}] - [@option{-S}|@option{--print-size}] [@option{-s}|@option{--print-armap}] - [@option{-A}|@option{-o}|@option{--print-file-name}][@option{--special-syms}] - [@option{-n}|@option{-v}|@option{--numeric-sort}] [@option{-p}|@option{--no-sort}] - [@option{-r}|@option{--reverse-sort}] [@option{--size-sort}] [@option{-u}|@option{--undefined-only}] - [@option{-t} @var{radix}|@option{--radix=}@var{radix}] [@option{-P}|@option{--portability}] - [@option{--target=}@var{bfdname}] [@option{-f}@var{format}|@option{--format=}@var{format}] - [@option{--defined-only}] [@option{-l}|@option{--line-numbers}] [@option{--no-demangle}] - [@option{-V}|@option{--version}] [@option{-X 32_64}] [@option{--help}] [@var{objfile}@dots{}] +nm [@option{-A}|@option{-o}|@option{--print-file-name}] [@option{-a}|@option{--debug-syms}] + [@option{-B}|@option{--format=bsd}] [@option{-C}|@option{--demangle}[=@var{style}]] + [@option{-D}|@option{--dynamic}] [@option{-f}@var{format}|@option{--format=}@var{format}] + [@option{-g}|@option{--extern-only}] [@option{-h}|@option{--help}] + [@option{-l}|@option{--line-numbers}] [@option{-n}|@option{-v}|@option{--numeric-sort}] + [@option{-P}|@option{--portability}] [@option{-p}|@option{--no-sort}] + [@option{-r}|@option{--reverse-sort}] [@option{-S}|@option{--print-size}] + [@option{-s}|@option{--print-armap}] [@option{-t} @var{radix}|@option{--radix=}@var{radix}] + [@option{-u}|@option{--undefined-only}] [@option{-V}|@option{--version}] + [@option{-X 32_64}] [@option{--defined-only}] [@option{--no-demangle}] + [@option{--plugin} @var{name}] [@option{--size-sort}] [@option{--special-syms}] + [@option{--synthetic}] [@option{--target=}@var{bfdname}] + [@var{objfile}@dots{}] @c man end @end smallexample @@ -920,11 +922,9 @@ @cindex external symbols Display only external symbols. -@item --plugin @var{name} -@cindex load plugin -Load the plugin called @var{name} to add support for extra target -types. This option is only available if the toolchain has been built -with plugin support enabled. +@item -h +@itemx --help +Show a summary of the options to @command{nm} and exit. @item -l @itemx --line-numbers @@ -952,6 +952,11 @@ Use the POSIX.2 standard output format instead of the default format. Equivalent to @samp{-f posix}. +@item -r +@itemx --reverse-sort +Reverse the order of the sort (whether numeric or alphabetic); let the +last come first. + @item -S @itemx --print-size Print both value and size of defined symbols for the @code{bsd} output style. @@ -966,10 +971,37 @@ (stored in the archive by @command{ar} or @command{ranlib}) of which modules contain definitions for which names. -@item -r -@itemx --reverse-sort -Reverse the order of the sort (whether numeric or alphabetic); let the -last come first. +@item -t @var{radix} +@itemx --radix=@var{radix} +Use @var{radix} as the radix for printing the symbol values. It must be +@samp{d} for decimal, @samp{o} for octal, or @samp{x} for hexadecimal. + +@item -u +@itemx --undefined-only +@cindex external symbols +@cindex undefined symbols +Display only undefined symbols (those external to each object file). + +@item -V +@itemx --version +Show the version number of @command{nm} and exit. + +@item -X +This option is ignored for compatibility with the AIX version of +@command{nm}. It takes one parameter which must be the string +@option{32_64}. The default mode of AIX @command{nm} corresponds +to @option{-X 32}, which is not supported by @sc{gnu} @command{nm}. + +@item --defined-only +@cindex external symbols +@cindex undefined symbols +Display only defined symbols for each object file. + +@item --plugin @var{name} +@cindex load plugin +Load the plugin called @var{name} to add support for extra target +types. This option is only available if the toolchain has been built +with plugin support enabled. @item --size-sort Sort symbols by size. The size is computed as the difference between @@ -986,39 +1018,16 @@ symbols used to mark transitions between ARM code, THUMB code and data. -@item -t @var{radix} -@itemx --radix=@var{radix} -Use @var{radix} as the radix for printing the symbol values. It must be -@samp{d} for decimal, @samp{o} for octal, or @samp{x} for hexadecimal. +@item --synthetic +Include synthetic symbols in the output. These are special symbols +created by the linker for various purposes. They are not shown by +default since they are not part of the binary's original source code. @item --target=@var{bfdname} @cindex object code format Specify an object code format other than your system's default format. @xref{Target Selection}, for more information. -@item -u -@itemx --undefined-only -@cindex external symbols -@cindex undefined symbols -Display only undefined symbols (those external to each object file). - -@item --defined-only -@cindex external symbols -@cindex undefined symbols -Display only defined symbols for each object file. - -@item -V -@itemx --version -Show the version number of @command{nm} and exit. - -@item -X -This option is ignored for compatibility with the AIX version of -@command{nm}. It takes one parameter which must be the string -@option{32_64}. The default mode of AIX @command{nm} corresponds -to @option{-X 32}, which is not supported by @sc{gnu} @command{nm}. - -@item --help -Show a summary of the options to @command{nm} and exit. @end table @c man end @@ -1060,7 +1069,6 @@ [@option{-R} @var{sectionname}|@option{--remove-section=}@var{sectionname}] [@option{-p}|@option{--preserve-dates}] [@option{-D}|@option{--enable-deterministic-archives}] - [@option{-U}|@option{--disable-deterministic-archives}] [@option{--debugging}] [@option{--gap-fill=}@var{val}] [@option{--pad-to=}@var{address}] @@ -1329,28 +1337,10 @@ @item -D @itemx --enable-deterministic-archives -@cindex deterministic archives -@kindex --enable-deterministic-archives Operate in @emph{deterministic} mode. When copying archive members and writing the archive index, use zero for UIDs, GIDs, timestamps, and use consistent file modes for all files. -If @file{binutils} was configured with -@option{--enable-deterministic-archives}, then this mode is on by default. -It can be disabled with the @samp{-U} option, below. - -@item -U -@itemx --disable-deterministic-archives -@cindex deterministic archives -@kindex --enable-deterministic-archives -Do @emph{not} operate in @emph{deterministic} mode. This is the -inverse of the @option{-D} option, above: when copying archive members -and writing the archive index, use their actual UID, GID, timestamp, -and file mode values. - -This is the default unless @file{binutils} was configured with -@option{--enable-deterministic-archives}. - @item --debugging Convert debugging information, if possible. This is not the default because only certain debugging formats are supported, and the @@ -2728,7 +2718,6 @@ [@option{-R} @var{sectionname} |@option{--remove-section=}@var{sectionname}] [@option{-o} @var{file}] [@option{-p}|@option{--preserve-dates}] [@option{-D}|@option{--enable-deterministic-archives}] - [@option{-U}|@option{--disable-deterministic-archives}] [@option{--keep-file-symbols}] [@option{--only-keep-debug}] [@option{-v} |@option{--verbose}] [@option{-V}|@option{--version}] @@ -2821,28 +2810,10 @@ @item -D @itemx --enable-deterministic-archives -@cindex deterministic archives -@kindex --enable-deterministic-archives Operate in @emph{deterministic} mode. When copying archive members and writing the archive index, use zero for UIDs, GIDs, timestamps, and use consistent file modes for all files. -If @file{binutils} was configured with -@option{--enable-deterministic-archives}, then this mode is on by default. -It can be disabled with the @samp{-U} option, below. - -@item -U -@itemx --disable-deterministic-archives -@cindex deterministic archives -@kindex --enable-deterministic-archives -Do @emph{not} operate in @emph{deterministic} mode. This is the -inverse of the @option{-D} option, above: when copying archive members -and writing the archive index, use their actual UID, GID, timestamp, -and file mode values. - -This is the default unless @file{binutils} was configured with -@option{--enable-deterministic-archives}. - @item -w @itemx --wildcard Permit regular expressions in @var{symbolname}s used in other command @@ -2936,7 +2907,7 @@ @c man end @end ignore -@node c++filt, addr2line, elfedit, Top +@node c++filt, addr2line, strip, Top @chapter c++filt @kindex c++filt @@ -4261,7 +4232,7 @@ @item -V @itemx --version-info -@cindex ELF version sections informations +@cindex ELF version sections information Displays the contents of the version sections in the file, it they exist. @@ -4299,7 +4270,7 @@ @item -c @itemx --archive-index @cindex Archive file symbol index information -Displays the file symbol index infomation contained in the header part +Displays the file symbol index information contained in the header part of binary archives. Performs the same function as the @option{t} command to @command{ar}, but without using the BFD library. @xref{ar}. @@ -4413,7 +4384,7 @@ @table @env -@itemx --input-mach=@var{machine} +@item --input-mach=@var{machine} Set the matching input ELF machine type to @var{machine}. If @option{--input-mach} isn't specified, it will match any ELF machine types. @@ -4421,21 +4392,21 @@ The supported ELF machine types are, @var{L1OM}, @var{K1OM} and @var{x86-64}. -@itemx --output-mach=@var{machine} +@item --output-mach=@var{machine} Change the ELF machine type in the ELF header to @var{machine}. The supported ELF machine types are the same as @option{--input-mach}. -@itemx --input-type=@var{type} +@item --input-type=@var{type} Set the matching input ELF file type to @var{type}. If @option{--input-type} isn't specified, it will match any ELF file types. The supported ELF file types are, @var{rel}, @var{exec} and @var{dyn}. -@itemx --output-type=@var{type} +@item --output-type=@var{type} Change the ELF file type in the ELF header to @var{type}. The supported ELF types are the same as @option{--input-type}. -@itemx --input-osabi=@var{osabi} +@item --input-osabi=@var{osabi} Set the matching input ELF file OSABI to @var{osabi}. If @option{--input-osabi} isn't specified, it will match any ELF OSABIs. @@ -4445,7 +4416,7 @@ @var{FreeBSD}, @var{TRU64}, @var{Modesto}, @var{OpenBSD}, @var{OpenVMS}, @var{NSK}, @var{AROS} and @var{FenixOS}. -@itemx --output-osabi=@var{osabi} +@item --output-osabi=@var{osabi} Change the ELF OSABI in the ELF header to @var{osabi}. The supported ELF OSABI are the same as @option{--input-osabi}.