aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat
-rw-r--r--binutils/binutils.texi128
-rw-r--r--binutils/c++filt.167
-rw-r--r--binutils/nm.187
-rw-r--r--binutils/objcopy.1111
-rw-r--r--binutils/objdump.134
-rw-r--r--binutils/ranlib.146
-rw-r--r--binutils/size.121
-rw-r--r--binutils/strings.1142
-rw-r--r--binutils/strip.182
9 files changed, 499 insertions, 219 deletions
diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index 2ab6be7..bf7f444 100644
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -554,7 +554,7 @@ objcopy [ -F @var{format} | --format=@var{format} ]
[ -O @var{format} | --output-format=@var{format} ]
[ -S | --strip-all ] [ -g | --strip-debug ]
[ -x | --discard-all ] [ -X | --discard-locals ]
- [ -v | --verbose ] [ -V | --version ]
+ [ -v | --verbose ] [ -V | --version ] [ --help ]
@var{infile} [@var{outfile}]
@end smallexample
@@ -619,6 +619,9 @@ Show the version number of @code{objcopy}.
@itemx --verbose
Verbose output: list all object files modified. In the case of
archives, @samp{objcopy -V} lists all members of the archive.
+
+@item --help
+Show a summary of the options to @code{objcopy}.
@end table
@iftex
@@ -642,7 +645,7 @@ nm [ -a | --debug-syms ] [ -g | --extern-only ]
[ -r | --reverse-sort ] [ -u | --undefined-only ]
[ -t @var{radix} | --radix=@var{radix} ] [ -P | --portability ]
[ --target=@var{bfdname} ] [ -f @var{format} | --format=@var{format} ]
- [ -V | --version ] [ @var{objfile}@dots{} ]
+ [ -V | --version ] [ --help ] [ @var{objfile}@dots{} ]
@end smallexample
GNU @code{nm} lists the symbols from object files @var{objfile}@dots{}.
@@ -714,7 +717,7 @@ listed.
@itemx --format=@var{format}
Use the output format @var{format}, which can be @code{bsd},
@code{sysv}, or @code{posix}. The default is @code{bsd}.
-Only the first character of @var{format} is significant, it can be
+Only the first character of @var{format} is significant; it can be
either upper or lower case.
@item -g
@@ -722,6 +725,12 @@ either upper or lower case.
@cindex external symbols
Display only external symbols.
+@item -n
+@itemx -v
+@itemx --numeric-sort
+Sort symbols numerically by their addresses, rather than alphabetically
+by their names.
+
@item -p
@itemx --no-sort
@cindex sorting symbols
@@ -733,12 +742,6 @@ encountered.
Use the POSIX.2 standard output format instead of the default format.
Equivalent to @samp{-f posix}.
-@item -n
-@itemx -v
-@itemx --numeric-sort
-Sort symbols numerically by their addresses, rather than alphabetically
-by their names.
-
@item -s
@itemx --print-armap
@cindex symbol index, listing
@@ -769,7 +772,10 @@ Display only undefined symbols (those external to each object file).
@item -V
@itemx --version
-Show the version number of @code{nm}.
+Show the version number of @code{nm} and exit.
+
+@item --help
+Show a summary of the options to @code{nm} and exit.
@end table
@node objdump, ranlib, nm, Top
@@ -781,8 +787,8 @@ Show the version number of @code{nm}.
@smallexample
objdump [ -a ] [ -b @var{bfdname} ] [ -d ] [ -f ]
[ -h | --header ] [ -i ] [ -j @var{section} ] [ -l ]
- [ -m @var{machine} ] [ -r | --reloc ] [ -s ]
- [ --stabs ] [ -t | --syms ] [ -x ]
+ [ -m @var{machine} ] [ -r | --reloc ] [ -s ] [ --stabs ]
+ [ -t | --syms ] [ -x ] [ --version ] [ --help ]
@var{objfile}@dots{}
@end smallexample
@@ -792,14 +798,14 @@ information is mostly useful to programmers who are working on the
compilation tools, as opposed to programmers who just want their
program to compile and work.
+@var{objfile}@dots{} are the object files to be examined. When you
+specify archives, @code{objdump} shows information on each of the member
+object files.
+
The long and short forms of options, shown here as alternatives, are
equivalent.
@table @code
-@item @var{objfile}@dots{}
-The object files to be examined. When you specify archives,
-@code{objdump} shows information on each of the member object files.
-
@item -a
@c print_arelt_descr
@cindex archive headers
@@ -842,6 +848,9 @@ each of the @var{objfile} files.
Header. Display summary information from the section headers of the
object file.
+@item --help
+Print a summary of the options to @code{objdump} and exit.
+
@item -i
@cindex architectures available
@cindex object formats available
@@ -895,13 +904,15 @@ output.
Symbol Table. Print the symbol table entries of the file.
This is similar to the information provided by the @samp{nm} program.
+@item --version
+Print the version number of @code{objdump} and exit.
+
@item -x
@cindex all header information, object file
@cindex header information, all
Display all available header information, including the symbol table and
relocation entries. Using @samp{-x} is equivalent to specifying all of
@samp{-a -f -h -r -t}.
-
@end table
@node ranlib, size, objdump, Top
@@ -953,11 +964,11 @@ size---for each of the object or archive files @var{objfile} in its
argument list. By default, one line of output is generated for each
object file or each module in an archive.
+@var{objfile}@dots{} are the object files to be examined.
+
The command line options have the following meanings:
-@table @code
-@item @var{objfile}@dots{}
-The object files to be examined.
+@table @code
@item -A
@itemx -B
@itemx --format=@var{compatibility}
@@ -1038,7 +1049,7 @@ Display the version number of @code{size}.
@cindex strings, printing
@smallexample
-strings [-afhov] [-n @var{min-len}] [-@var{min-len}] [-t @var{radix}] [-]
+strings [-afov] [-@var{min-len}] [-n @var{min-len}] [-t @var{radix}] [-]
[--all] [--print-file-name] [--bytes=@var{min-len}] [--radix=@var{radix}]
[--help] [--version] @var{file}@dots{}
@end smallexample
@@ -1064,20 +1075,19 @@ the whole files.
@itemx --print-file-name
Print the name of the file before each string.
-@item -h
-@itemx --help
+@item --help
Print a summary of the program usage on the standard output and exit.
-@item -n @var{min-len}
@itemx -@var{min-len}
+@item -n @var{min-len}
@itemx --bytes=@var{min-len}
Print sequences of characters that are at least @var{min-len} characters
long, instead of the default 4.
@item -o
-Like @samp{-t o}.
-Some other versions of @code{strings} have @samp{-o} act like @samp{-t d} instead.
-Since we can not be compatible with both ways, we simply chose one.
+Like @samp{-t o}. Some other versions of @code{strings} have @samp{-o}
+act like @samp{-t d} instead. Since we can not be compatible with both
+ways, we simply chose one.
@item -t @var{radix}
@itemx --radix=@var{radix}
@@ -1104,19 +1114,27 @@ strip [ -F @var{format} | --format=@var{format} | --target=@var{format} ]
[ -O @var{format} | --output-format=@var{format} ]
[ -s | --strip-all ] [ -S | -g | --strip-debug ]
[ -x | --discard-all ] [ -X | --discard-locals ]
- [ -v | --verbose ] [ -V | --version ]
+ [ -v | --verbose ] [ -V | --version ] [ --help ]
@var{objfile}@dots{}
@end smallexample
GNU @code{strip} discards all symbols from object files
@var{objfile}. The list of object files may include archives.
-
-@code{strip} will not execute unless at least one object file is listed.
+At least one object file must be given.
@code{strip} modifies the files named in its argument,
rather than writing modified copies under different names.
@table @code
+@item -F @var{format}
+@itemx --format=@var{format}
+@itemx --target=@var{format}
+Treat the original @var{objfile} as a file with the object
+code format @var{format}, and rewrite it in the same format.
+
+@item --help
+Show a summary of the options to @code{strip} and exit.
+
@item -I @var{format}
@itemx --input-format=@var{format}
Treat the original @var{objfile} as a file with the object
@@ -1126,12 +1144,6 @@ code format @var{format}.
@itemx --output-format=@var{format}
Replace @var{objfile} with a file in the output format @var{format}.
-@item -F @var{format}
-@itemx --format=@var{format}
-@itemx --target=@var{format}
-Treat the original @var{objfile} as a file with the object
-code format @var{format}, and rewrite it in the same format.
-
@item -s
@itemx --strip-all
Remove all symbols.
@@ -1166,10 +1178,16 @@ archives, @samp{strip -v} lists all members of the archive.
@kindex c++filt
@cindex demangling C++ symbols
+@smallexample
+c++filt [ -_ | --strip-underscores ]
+ [ -s @var{format} | --format=@var{format} ]
+ [ --help ] [ --version ] [ @var{arg}@dots{} ]
+@end smallexample
+
The C++ language provides function overloading, which means that you can
write many functions with the same name (providing each takes parameters
of different types). All C++ function names are encoded into a
-low-level assembly label (in some circles this is described as
+low-level assembly label (this process is known as
@dfn{mangling}). The @code{c++filt} program does the inverse mapping: it
decodes (@dfn{demangles}) low-level names into user-level names so that
the linker can keep these overloaded functions from clashing.
@@ -1194,10 +1212,34 @@ c++filt @var{symbol}
All results are printed on the standard output.
-Note that on some systems, both the C and C++ compilers put an
-underscore in front of every name. (I.e. the C name @code{foo} gets the
-low-level name @code{_foo}.) On such systems, @code{c++filt} removes
-any initial underscore of a potential label.
+@table @code
+@item -_
+@item --strip-underscores
+On some systems, both the C and C++ compilers put an underscore in front
+of every name. For example, the C name @code{foo} gets the low-level
+name @code{_foo}. This option removes the initial underscore.
+
+@item -s @var{format}
+@itemx --format=@var{format}
+GNU @code{nm} can decode three different methods of mangling, used by
+different C++ compilers. The argument to this option selects which
+method it uses:
+
+@table @code
+@item gnu
+the one used by the GNU compiler (the default method)
+@item lucid
+the one used by the Lucid compiler
+@item arm
+the one specified by the C++ Annotated Reference Manual
+@end table
+
+@item --help
+Print a summary of the options to @code{c++filt} and exit.
+
+@item --version
+Print the version number of @code{c++filt} and exit.
+@end table
@quotation
@emph{Warning:} @code{c++filt} is a new utility, and the details of its
@@ -1206,14 +1248,14 @@ a command-line option may be required in the the future to decode a name
passed as an argument on the command line; in other words,
@example
-c++filt @var{SYMBOL}
+c++filt @var{symbol}
@end example
@noindent
may in a future release become
@example
-c++filt @var{flag} @var{SYMBOL}
+c++filt @var{option} @var{symbol}
@end example
@end quotation
diff --git a/binutils/c++filt.1 b/binutils/c++filt.1
index d3e8365..c8a64c5 100644
--- a/binutils/c++filt.1
+++ b/binutils/c++filt.1
@@ -8,30 +8,35 @@
..
.SH NAME
-c++filt\(em\&demangles C++ symbols
+c++filt\(em\&demangle C++ symbols
.SH SYNOPSIS
+.hy 0
+.na
+.TP
.B c++filt
-[
-.B -_
-]
-
+.RB "[\|" \-_ | \-\-strip-underscores "\|]"
+.RB "[\|" "\-s {gnu,lucid,arm} " | " \-\-format={gnu,lucid,arm}" "\|]"
+.RB "[\|" \-\-help "\|]"
+.RB "[\|" \-\-version "\|]"
+.RB "[\|" arg "...\|]"
.SH DESCRIPTION
The C++ language provides function overloading, which means that you can
write many functions with the same name (providing each takes parameters
of different types). All C++ function names are encoded into a
-low-level assembly label (in some circles this is described as
-@dfn{mangling}). The
+low-level assembly label (this process is known as
+.I mangling\c
+). The
.B c++filt
program does the inverse mapping: it decodes (\fIdemangles\fR)
low-level names into user-level names so that the linker can keep
these overloaded functions from clashing.
-
+.PP
Every alphanumeric word (consisting of letters, digits, underscores,
dollars, or periods) seen in the input is a potential label. If the
label decodes into a C++ name, the C++ name replaces the low-level
name in the output.
-
+.PP
A typical use of
.B c++filt
is to pipe the output of
@@ -43,22 +48,48 @@ as a filter:
.RS
.B nm \fIobjfile\fB | c++filt
.RE
-
+.PP
You can also use
.B c++filt
to decipher individual symbols by specifying these symbols on the
command line.
-
+.PP
All results are printed on the standard output.
-
-Note that on some systems, both the C and C++ compilers put an
-underscore in front of every name. (I.e. the C name
+.SH OPTIONS
+.TP
+.B \-_
+.TP
+.B \-\-strip\-underscores
+On some systems, both the C and C++ compilers put an
+underscore in front of every name. For example, the C name
.B foo
gets the low-level name
-.BR _foo .)
-To remove the leading underscore, specify the option
-.B -_
-on the command line.
+.BR _foo .
+This option removes the leading underscore.
+
+.TP
+.B "\-s {gnu,lucid,arm}"
+.TP
+.B \-\-format={gnu,lucid,arm}
+GNU
+.B nm
+can decode three different methods of mangling, used by different C++
+compilers. This option selects which method it uses: the one used by
+the GNU compiler, the one used by the Lucid compiler, or the one
+specified by the C++ Annotated Reference Manual. The default is the
+GNU style.
+
+.TP
+.B \-\-help
+Print a summary of the options to
+.B c++filt
+and exit.
+
+.TP
+.B \-\-version
+Print the version number of
+.B c++filt
+and exit.
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
diff --git a/binutils/nm.1 b/binutils/nm.1
index 26ed5a0..f2d629a 100644
--- a/binutils/nm.1
+++ b/binutils/nm.1
@@ -23,9 +23,12 @@ nm\(em\&list symbols from object files.
.RB "[\|" \-p | \-\-no\-sort "\|]"
.RB "[\|" \-r | \-\-reverse\-sort "\|]"
.RB "[\|" \-u | \-\-undefined\-only "\|]"
-.RB "[\|" "\-\-target="\c
-.I bfdname\c
-\&\|]
+.RB "[\|" \-\-help "\|]"
+.RB "[\|" \-\-version "\|]"
+.RB "[\|" "\-t \fIradix" | \-\-radix=\fIradix "\|]"
+.RB "[\|" \-P | --portability "\|]"
+.RB "[\|" "\-f \fIformat" | \-\-format=\fIformat "\|]"
+.RB "[\|" "\-\-target=\fIbfdname" "\|]"
.RB "[\|" \c
.I objfile\c
\&.\|.\|.\|]
@@ -34,22 +37,27 @@ nm\(em\&list symbols from object files.
.SH DESCRIPTION
GNU \c
.B nm\c
-\& will list the symbols from object files \c
+\& lists the symbols from object files \c
.I objfile\c
-\&.
+\&. If no object files are given as arguments, \c
+.B nm\c
+\& assumes `\|\c
+.B a.out\c
+\|'.
.SH OPTIONS
The long and short forms of options, shown here as alternatives, are
equivalent.
.TP
-.IR "objfile" .\|.\|.
-Object files whose symbols are to be listed. If no object files are
-listed as arguments, \c
-.B nm\c
-\& assumes `\|\c
-.B a.out\c
-\|'.
+.B \-A
+.TP
+.B \-o
+.TP
+.B \-\-print\-file\-name
+Precede each symbol by the name of the input file where it was found,
+rather than identifying the input file once only before all of its
+symbols.
.TP
.B \-a
@@ -58,12 +66,28 @@ listed as arguments, \c
Display debugger-only symbols; normally these are not listed.
.TP
+.B "\-f \fIformat"
+Use the output format \fIformat\fP, which can be ``bsd'',
+``sysv'', or ``posix''. The default is `bsd''.
+Only the first character of \fIformat\fP is significant; it can be
+either upper or lower case.
+
+.TP
.B \-g
.TP
.B \-\-extern\-only
Display only external symbols.
.TP
+.B \-n
+.TP
+.B \-v
+.TP
+.B \-\-numeric\-sort
+Sort symbols numerically by their addresses, not alphabetically by their
+names.
+
+.TP
.B \-p
.TP
.B \-\-no\-sort
@@ -71,11 +95,11 @@ Don't bother to sort the symbols in any order; just print them in the
order encountered.
.TP
-.B \-n
+.B \-P
.TP
-.B \-\-numeric\-sort
-Sort symbols numerically by their addresses, not alphabetically by their
-names.
+.B \-\-portability
+Use the POSIX.2 standard output format instead of the default format.
+Equivalent to ``\-f posix''.
.TP
.B \-s
@@ -90,14 +114,6 @@ When listing symbols from archive members, include the index: a mapping
contain definitions for what names.
.TP
-.B \-o
-.TP
-.B \-\-print\-file\-name
-Precede each symbol by the name of the input file where it was found,
-rather than identifying the input file once only before all of its
-symbols.
-
-.TP
.B \-r
.TP
.B \-\-reverse\-sort
@@ -105,7 +121,14 @@ Reverse the sense of the sort (whether numeric or alphabetic); let the
last come first.
.TP
-.BI "\-\-target " "bfdname"\c
+.B "\-t \fIradix"
+.TP
+.B "\-\-radix=\fIradix"
+Use \fIradix\fP as the radix for printing the symbol values. It must be
+``d'' for decimal, ``o'' for octal, or ``x'' for hexadecimal.
+
+.TP
+.BI "\-\-target=" "bfdname"\c
\&
Specify an object code format other than your system's default format.
See
@@ -118,7 +141,19 @@ for information on listing available formats.
.B \-\-undefined\-only
Display only undefined symbols (those external to each object file).
-.PP
+.TP
+.B \-V
+.TP
+.B \-\-version
+Show the version number of
+.B nm
+and exit.
+
+.TP
+.B \-\-help
+Show a summary of the options to
+.B nm
+and exit.
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
diff --git a/binutils/objcopy.1 b/binutils/objcopy.1
index 2323e7e..b9620de 100644
--- a/binutils/objcopy.1
+++ b/binutils/objcopy.1
@@ -8,48 +8,25 @@
..
.SH NAME
-objcopy\(em\&copies and translates object files
+objcopy\(em\&copy and translate object files
.SH SYNOPSIS
.hy 0
.na
+.TP
.B objcopy
-.RS
-[
-.B -F \fIformat\fB | --format=\fIformat\fB
-]
-.br
-[
-.B -I \fIformat\fB | --input-format=\fIformat\fB
-]
-.br
-[
-.B -O \fIformat\fB | --output-format=\fIformat\fB
-]
-.br
-[
-.B -S | --strip-all
-] [
-.B -g | --strip-debug
-]
-.br
-[
-.B -x | --discard-all
-] [
-.B -X | --discard-locals
-]
-.br
-[
-.B -v | --verbose
-] [
-.B -V | --version
-]
-.br
-.I infile
-[
-.I outfile
-]
-.RE
+.RB "[\|" \-F \fIformat\fB | \-\-format=\fIformat\fB "\|]"
+.RB "[\|" \-I \fIformat\fB | \-\-input\-format=\fIformat\fB "\|]"
+.RB "[\|" \-O \fIformat\fB | \-\-output\-format=\fIformat\fB "\|]"
+.RB "[\|" \-S | \-\-strip\-all "\|]"
+.RB "[\|" \-g | \-\-strip\-debug "\|]"
+.RB "[\|" \-x | \-\-discard\-all "\|]"
+.RB "[\|" \-X | \-\-discard\-locals "\|]"
+.RB "[\|" \-v | \-\-verbose "\|]"
+.RB "[\|" \-V | \-\-version "\|]"
+.RB "[\|" \-\-help "\|]"
+.B infile
+.RB "[\|" outfile "\|]"
.SH DESCRIPTION
The GNU
.B objcopy
@@ -60,7 +37,7 @@ write the destination object file in a format different from that of
the source object file. The exact behavior of
.B objcopy
is controlled by command-line options.
-
+.PP
.B objcopy
creates temporary files to do its translations and deletes them
afterward.
@@ -68,51 +45,77 @@ afterward.
uses BFD to do all its translation work; it knows about all the
formats BFD knows about, and thus is able to recognize most formats
without being told explicitly.
-
-.SH OPTIONS
-.TP 0.5i
-.I infile\fR,\fI outfile
-The source and output files respectively. If you do not specify
+.PP
+.I infile
+and
+.I outfile
+are the source and output files respectively. If you do not specify
.IR outfile ,
.B objcopy
creates a temporary file and destructively renames the result with the
name of the input file.
+
+.SH OPTIONS
.TP
-.B -I \fIformat\fB, --input-format=\fIformat\fB
+.B \-I \fIformat
+.TP
+.B \-\-input\-format=\fIformat
Consider the source file's object format to be
.IR format ,
rather than attempting to deduce it.
.TP
-.B -O \fIformat\fB, --output-format=\fIformat\fB
+.B \-O \fIformat
+.TP
+.B \-\-output\-format=\fIformat
Write the output file using the object format
.IR format .
.TP
-.B -F \fIformat\fB, --format=\fIformat\fB
+.B \-F \fIformat\fB
+.TP
+.B \-\-format=\fIformat
Use
.I format
as the object format for both the input and the output file; i.e.
simply transfer data from source to destination with no translation.
.TP
-.B -S, --strip-all
+.B \-S
+.TP
+.B \-\-strip\-all
Do not copy relocation and symbol information from the source file.
.TP
-.B -g, --strip-debug
+.B \-g
+.TP
+.B \-\-strip\-debug
Do not copy debugging symbols from the source file.
.TP
-.B -x, --discard-all
+.B \-x
+.TP
+.B \-\-discard\-all
Do not copy non-global symbols from the source file.
.TP
-.B -X, --discard-locals
+.B \-X
+.TP
+.B \-\-discard\-locals
Do not copy compiler-generated local symbols. (These usually start
with "L" or ".").
.TP
-.B -v, --verbose
+.B \-v
+.TP
+.B \-\-verbose
Verbose output: list all object files modified. In the case of
-archives, "\fBobjcopy -V\fR" lists all members of the archive.
+archives, "\fBobjcopy \-V\fR" lists all members of the archive.
+.TP
+.B \-V
.TP
-.B -V, --version
+.B \-\-version
Show the version number of
-.BR objcopy .
+.B objcopy
+and exit.
+.TP
+.B \-\-help
+Show a summary of the options to
+.B objcopy
+and exit.
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
entry in
diff --git a/binutils/objdump.1 b/binutils/objdump.1
index c7c4f0a..3d0a5f0 100644
--- a/binutils/objdump.1
+++ b/binutils/objdump.1
@@ -14,7 +14,7 @@ objdump\(em\&display information from object files.
.hy 0
.na
.TP
-.B objdump
+.B objdump
.RB "[\|" \-a "\|]"
.RB "[\|" "\-b\ "\c
.I bfdname\c
@@ -35,6 +35,8 @@ objdump\(em\&display information from object files.
.RB "[\|" \-\-stabs "\|]"
.RB "[\|" \-t | \-\-syms "\|]"
.RB "[\|" \-x "\|]"
+.RB "[\|" \-\-version "\|]"
+.RB "[\|" \-\-help "\|]"
.I objfile\c
\&.\|.\|.
.ad b
@@ -47,17 +49,17 @@ The options control what particular information to display. This
information is mostly useful to programmers who are working on the
compilation tools, as opposed to programmers who just want their
program to compile and work.
-.SH OPTIONS
-Where long and short forms of an option are shown together, they are
-equivalent.
-
-.TP
+.PP
.IR "objfile" .\|.\|.
-The object files to be examined. When you specify archives,
+are the object files to be examined. When you specify archives,
\c
.B objdump\c
\& shows information on each of the member object files.
+.SH OPTIONS
+Where long and short forms of an option are shown together, they are
+equivalent.
+
.TP
.B \-a
If any files from \c
@@ -76,7 +78,7 @@ the object file format of each archive member.
.TP
.BI "-b " "bfdname"\c
\&
-You can specify a particular object-code format for your object files as
+Specify the object-code format for the object files to be
\c
.I bfdname\c
\&. This may not be necessary; \c
@@ -89,7 +91,7 @@ objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
.br
.sp
-Displays summary information from the section headers (`\|\c
+display summary information from the section headers (`\|\c
.B \-h\c
\|') of
`\|\c
@@ -124,6 +126,12 @@ Header. Display summary information from the section headers of the
object file.
.TP
+.B \-\-help
+Print a summary of the options to
+.B objdump
+and exit.
+
+.TP
.B \-i
Display a list showing all architectures and object formats available
for specification with \c
@@ -186,6 +194,12 @@ This is similar to the information provided by the `\|\c
\|' program.
.TP
+.B \-\-version
+Print the version number of
+.B objdump
+and exit.
+
+.TP
.B \-x
Display all available header information, including the symbol table and
relocation entries. Using `\|\c
@@ -195,8 +209,6 @@ relocation entries. Using `\|\c
.B \-a \-f \-h \-r \-t\c
\|'.
-.PP
-
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
entry in
diff --git a/binutils/ranlib.1 b/binutils/ranlib.1
index 9668f83..ea120f6 100644
--- a/binutils/ranlib.1
+++ b/binutils/ranlib.1
@@ -14,38 +14,42 @@ ranlib\(em\&generate index to archive.
.hy 0
.na
.B ranlib \c
+.RB "[\|" \-v | \-V "\|]"
.I archive\c
\&
.ad b
.hy 1
.SH DESCRIPTION
-\c
-.B ranlib\c
-\& generates an index to the contents of an archive, and
+.B ranlib
+generates an index to the contents of an archive, and
stores it in the archive. The index lists each symbol defined by a
member of an archive that is a relocatable object file.
-
-You may use `\|\c
-.B nm \-s\c
-\|' or `\|\c
-.B nm +print-armap\c
-\|' to list this index.
-
+.PP
+You may use
+.RB ` "nm \-s" '
+or
+.RB ` "nm \-\-print-armap" '
+to list this index.
+.PP
An archive with such an index speeds up linking to the library, and
allows routines in the library to call each other without regard to
their placement in the archive.
+.PP
+The GNU
+.B ranlib
+program is another form of GNU
+.BR ar ;
+running
+.B ranlib
+is completely equivalent to executing
+.RB ` "ar \-s" '.
-The GNU \c
-.B ranlib\c
-\& program is another form of GNU \c
-.B ar\c
-\&; running
-\c
-.B ranlib\c
-\& is completely equivalent to executing `\|\c
-.B ar \-s\c
-\|'.
-
+.SH OPTIONS
+.TP
+.B \-v
+Print the version number of
+.B ranlib
+and exit.
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
diff --git a/binutils/size.1 b/binutils/size.1
index 13351a4..364293b 100644
--- a/binutils/size.1
+++ b/binutils/size.1
@@ -35,18 +35,14 @@ size\(em\&list section sizes and total size.
The GNU \c
.B size\c
\& utility lists the section sizes\(em\&and the total
-size\(em\&for each of the object files \c
-.I objfile\c
-\& in its argument list.
+size\(em\&for each of the object files
+.I objfile
+in its argument list.
By default, one line of output is generated for each object file or each
module in an archive.
.SH OPTIONS
.TP
-.IR "objfile" .\|.\|.
-The object files to be examined.
-
-.TP
.B \-A
.TP
.B \-B
@@ -140,17 +136,12 @@ Display version number information on \c
.B size\c
\& itself.
-.PP
-
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
entry in
-.B
-info\c
-\&;
-.I
-The GNU Binary Utilities\c
-\&, Roland H. Pesch (October 1991);
+.BR info ;
+.IR The GNU Binary Utilities ,
+ Roland H. Pesch (October 1991);
.BR ar "(" 1 "),"
.BR objdump ( 1 ).
diff --git a/binutils/strings.1 b/binutils/strings.1
new file mode 100644
index 0000000..81d0d60
--- /dev/null
+++ b/binutils/strings.1
@@ -0,0 +1,142 @@
+.\" Copyright (c) 1993 Free Software Foundation
+.\" See section COPYING for conditions for redistribution
+.TH nm 1 "25 June 1993" "cygnus support" "GNU Development Tools"
+.de BP
+.sp
+.ti \-.2i
+\(**
+..
+
+.SH NAME
+strings\(em\&print the strings of printable characters in files
+
+.SH SYNOPSIS
+.hy 0
+.na
+.TP
+.B strings
+.RB "[\|" \-a | \-\c
+.RB | \-\-all "\|]"
+.RB "[\|" \-f | \-\-print\-file\-name "\|]"
+.RB "[\|" \-o "\|]"
+.RB "[\|" \-\-help "\|]"
+.RB "[\|" \-v | \-\-version "\|]"
+.RB "[\|" \-n
+.I min\-len\c
+.RI | \-min\-len\c
+.RB | "\-\-bytes="\c
+.I min\-len\c
+\&\|]
+.RB "[\|" \-t
+.I {o,x,d}\c
+.RB | "\-\-radix="\c
+.I {o,x,d}\c
+\&\|]
+.I file\c
+.ad b
+.hy 1
+.SH DESCRIPTION
+For each
+.I file
+given, GNU \c
+.B strings
+prints the printable character sequences that are at least 4
+characters long (or the number given with the options below) and are
+followed by a NUL or newline character. By default, it only prints
+the strings from the initialized data sections of object files; for
+other types of files, it prints the strings from the whole file.
+
+.PP
+.B strings
+is mainly useful for determining the contents of non-text files.
+
+.SH OPTIONS
+The long and short forms of options, shown here as alternatives, are
+equivalent.
+
+.TP
+.B \-a
+.TP
+.B \-\-all
+.TP
+.B \-
+Do not scan only the initialized data section of object files; scan
+the whole files.
+
+.TP
+.B \-f
+.TP
+.B \-\-print\-file\-name
+Print the name of the file before each string.
+
+.TP
+.B \-\-help
+Print a summary of the options to
+.B strings
+on the standard output and exit.
+
+.TP
+.B \-v
+.TP
+.B \-\-version
+Print the version number
+of
+.B strings
+on the standard output and exit.
+
+.TP
+.B "\-n \fImin\-len\fP"
+.B "\-\fImin\-len\fP"
+.TP
+.B "\-bytes=\fImin\-len\fP"
+Print sequences of characters that are at least
+.I min\-len
+characters long, instead of the default 4.
+
+.TP
+.BR "\-t " {o,x,d}
+.TP
+.BR "\-\-radix=" {o,x,d}
+Print the offset within the file before each string. The single
+character argument specifies the radix of the offset\(emoctal,
+hexadecimal, or decimal.
+
+.TP
+.B \-o
+Like
+.BR "\-t o" .
+
+.PP
+
+.SH "SEE ALSO"
+.RB "`\|" binutils "\|'"
+entry in
+.B
+info\c
+\&;
+.I
+The GNU Binary Utilities\c
+\&, Roland H. Pesch (October 1991);
+.BR ar ( 1 ),
+.BR nm ( 1 ),
+.BR objdump ( 1 ),
+.BR ranlib ( 1 ).
+
+
+.SH COPYING
+Copyright (c) 1993 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
+are preserved on all copies.
+.PP
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+.PP
+Permission is granted to copy and distribute translations of this
+manual into another language, under the above conditions for modified
+versions, except that this permission notice may be included in
+translations approved by the Free Software Foundation instead of in
+the original English.
diff --git a/binutils/strip.1 b/binutils/strip.1
index 1c69162..4ca0dbb 100644
--- a/binutils/strip.1
+++ b/binutils/strip.1
@@ -21,51 +21,70 @@ strip\(em\&Discard symbols from object files.
.RB "[\|" \-X | \-\-discard\-locals "\|]"
.RB "[\|" \-v | \-\-verbose "\|]"
.RB "[\|" \-V | \-\-version "\|]"
+.RB "[\|" \-V | \-\-help "\|]"
.I objfile\c
\&.\|.\|.
.SH DESCRIPTION
-GNU \c
-.B strip\c
-\& discards all symbols from the object files
-\c
-.I objfile\c
-\&. The list of object files may include archives.
-
-\c
-.B strip\c
-\& will not execute unless at least one object file is listed.
+GNU
+.B strip
+discards all symbols from the object files
+.IR objfile .
+The list of object files may include archives.
+At least one object file must be given.
-\& \c
-.B strip\c
-\& modifies the files named in its argument,
+.P
+.B strip
+modifies the files named in its argument,
rather than writing modified copies under different names.
.SH OPTIONS
.TP
-.B "\-F \fIformat\fP \-\-format=\fIformat\fP \-\-target=\fIformat\fP"
+.B "\-F \fIformat"
+.TP
+.B "\-\-format=\fIformat"
+.TP
+.B "\-\-target=\fIformat"
Treat the original \fIobjfile\fP as a file with the object
code format \fIformat\fP, and rewrite it in the same format.
.TP
-.B "\-I \fIformat\fP \-\-input\-format=\fIformat\fP"
+.B \-\-help
+Show a summary of the options to
+.B strip
+and exit.
+
+.TP
+.B "\-I \fIformat
+.TP
+.B "\-\-input\-format=\fIformat"
Treat the original \fIobjfile\fP as a file with the object
code format \fIformat\fP.
.TP
-.B "\-O \fIformat\fP \-\-output\-format=\fIformat\fP"
+.B "\-O \fIformat\fP"
+.TP
+.B "\-\-output\-format=\fIformat"
Replace \fIobjfile\fP with a file in the output format \fIformat\fP.
.TP
-.B "\-s \-\-strip\-all"
+.B \-s
+.TP
+.B \-\-strip\-all
Remove all symbols.
.TP
-.B "\-S -g \-\-strip\-debug"
+.B \-S
+.TP
+.B -g
+.TP
+.B \-\-strip\-debug
Remove debugging symbols only.
.TP
-.B "\-x \-\-discard\-all"
+.B \-x
+.TP
+.B \-\-discard\-all
Remove non-global symbols.
.TP
@@ -74,25 +93,26 @@ Remove compiler-generated local symbols.
(These usually start with ``L'' or ``.''.)
.TP
-.B "\-v \-\-verbose"
+.B \-v
+.TP
+.B \-\-verbose
Verbose output: list all object files modified. In the case of
-archives, ``strip \-V'' lists all members of the archive.
+archives,
+.B "strip \-V"
+lists all members of the archive.
.TP
-.B "\-V \-\-version
-Show the version number for \fBstrip\fP.
-
-.PP
+.B \-V
+.TP
+.B \-\-version
+Show the version number for \fBstrip\fP and exit.
.SH "SEE ALSO"
.RB "`\|" binutils "\|'"
entry in
-.B
-info\c
-\&;
-.I
-The GNU Binary Utilities\c
-\&, Roland H. Pesch (October 1991).
+.BR info ;
+.IR "The GNU Binary Utilities ,
+Roland H. Pesch (October 1991).
.SH COPYING
Copyright (c) 1991 Free Software Foundation, Inc.
generated by cgit v1.1 at 2024-07-13 06:37:40 +0000