OpenE2K
/
binutils-gdb
12
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

* binutils.tex: Document yesterday's changes to strip and copy.

This commit is contained in:
Per Bothner 1992-10-15 20:59:17 +00:00
parent 327f7197b0
commit 918c2f61e5
2 changed files with 132 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
binutils/TODO
View File

@ -1,7 +1,9 @@
o - strip o - strip
Implement various options
Make faster by using ftruncate if available (and format is suitable). Make faster by using ftruncate if available (and format is suitable).
o - nm, objdump
add option to demangle C++ names
o - See also ../ld/TODO and ../bfd/TODO. o - See also ../ld/TODO and ../bfd/TODO.
OLD: OLD:

192
binutils/binutils.texi
View File

@ -168,7 +168,7 @@ 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 allows routines in the library to call each other without regard to
their placement in the archive. their placement in the archive.
You may use @samp{nm -s} or @samp{nm +print-armap} to list this index You may use @samp{nm -s} or @samp{nm --print-armap} to list this index
table. If an archive lacks the table, another form of @code{ar} called table. If an archive lacks the table, another form of @code{ar} called
@code{ranlib} can be used to add just the table. @code{ranlib} can be used to add just the table.
@ -536,50 +536,79 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
@end table @end table
@node copy, nm, ar, Top @node copy, nm, ar, Top
@chapter copy @chapter copy
@smallexample @smallexample
copy [-S] [-s srcfmt] [-d dtfmt] [-b bothfmts] infile [outfile] [-vV] copy [ -F @var{format} | --format=@var{format} ]
[ -I @var{format} | --input-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 ]
@var{infile} [@var{outfile}]
@end smallexample @end smallexample
The Gnu @code{copy} utility copies the contents of object files. @code{copy} The GNU @code{copy} utility copies the contents of an object file to
uses the Gnu BFD Library to read and write the object files. It another. @code{copy} uses the GNU BFD Library to read and write the
can write the destination object file in a format different from that object files. It can write the destination object file in a format
of the source object file. The exact behavior of @code{copy} is controlled different from that of the source object file. The exact behavior of
by command-line options. @code{copy} is controlled by command-line options.
@code{copy} creates temporary files to do its translations and @code{copy} creates temporary files to do its translations and
deletes them afterward. If no destination file is specified, a deletes them afterward. @code{copy} uses BFD to do all its
temporary file is created and the result is destructively renamed with
the name of the input file. @code{copy} uses BFD to do all its
translation work; it knows about all the formats BFD knows about, and translation work; it knows about all the formats BFD knows about, and
thus is able to recognize most formats without being told explicitly. thus is able to recognize most formats without being told explicitly.
@xref{BFD,,BFD,ld.info,Using LD, the GNU linker}. @xref{BFD,,BFD,ld.info,Using LD, the GNU linker}.
@table @code @table @code
@item @var{infile}
@itemx @var{outfile}
The source and output files respectively.
If you do not specify @var{outfile}, @code{copy} creates a
temporary file and destructively renames the result with
the name of the input file.
@item -I @var{format}
@itemx --input-format=@var{format}
Treat the source file's object format as specified, rather than
attempting to deduce it.
@item -O @var{format}
@itemx --output-format=@var{format}
Write the output file using the specified object format.
@item -F @var{format}
@itemx --format=@var{format}
Use @var{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.
@item -S @item -S
@cindex calls @samp{strip} @itemx --strip-all
Causes @code{copy} to strip relocation and symbol information from the Do not copy relocation and symbol information from the source file.
source file as the file is copied.
@item -s @var{format} @item -g
Explicitly specifies the object format of the source file. @itemx --strip-debug
Do not copy debugging symbols from the source file.
@item -d @var{format} @item -x
Explicitly specifies the object format of the desired output file. @itemx --discard-all
Do not copy non-global symbols from the source file.
@c FIXME any reason to prefer "non-global" to "local" here?
@item -b @var{format} @item -X
Explicitly specifies that the object format of the output should be the @itemx --discard-locals
same as the input, i.e. a simple data transfer from source to Do not copy compiler-generated local symbols.
destination with no translation involved. (These usually start with @samp{L} or @samp{.}.)
@item -v
Show version number.
@item -V @item -V
Requests verbose output. @itemx --version
Show version number.
@item -v
@itemx --verbose
Verbose output: list all object files modified. In the case of
archives, @samp{copy -V} lists all members of the archive.
@end table @end table
@iftex @iftex
@ -597,11 +626,11 @@ The GNU linker @code{ld} is now described in a separate manual.
@kindex nm @kindex nm
@smallexample @smallexample
nm [ -a | +debug-syms ] [ -g | +extern-only ] nm [ -a | --debug-syms ] [ -g | --extern-only ]
[ -s | +print-armap ] [ -o | +print-file-name ] [ -s | --print-armap ] [ -o | --print-file-name ]
[ -n | +numeric-sort ] [ -p | +no-sort ] [ -n | --numeric-sort ] [ -p | --no-sort ]
[ -r | +reverse-sort ] [ -u | +undefined-only ] [ -r | --reverse-sort ] [ -u | --undefined-only ]
[ +target @var{bfdname} ] [ --target @var{bfdname} ]
[ @var{objfiles}@dots{} ] [ @var{objfiles}@dots{} ]
@end smallexample @end smallexample
@ -617,35 +646,35 @@ Object files whose symbols are to be listed. If no object files are
listed as arguments, @code{nm} assumes @samp{a.out}. listed as arguments, @code{nm} assumes @samp{a.out}.
@item -a @item -a
@itemx +debug-syms @itemx --debug-syms
@cindex debugging symbols @cindex debugging symbols
Display debugger-only symbols; normally these are not listed. Display debugger-only symbols; normally these are not listed.
@item -g @item -g
@itemx +extern-only @itemx --extern-only
@cindex external symbols @cindex external symbols
Display only external symbols. Display only external symbols.
@item -p @item -p
@itemx +no-sort @itemx --no-sort
@cindex sorting symbols @cindex sorting symbols
Don't bother to sort the symbols in any order; just print them in the Don't bother to sort the symbols in any order; just print them in the
order encountered. order encountered.
@item -n @item -n
@itemx +numeric-sort @itemx --numeric-sort
Sort symbols numerically by their addresses, not alphabetically by their Sort symbols numerically by their addresses, not alphabetically by their
names. names.
@item -s @item -s
@itemx +print-armap @itemx --print-armap
@cindex symbol index, listing @cindex symbol index, listing
When listing symbols from archive members, include the index: a mapping When listing symbols from archive members, include the index: a mapping
(stored in the archive by @code{ar} or @code{ranlib}) of what modules (stored in the archive by @code{ar} or @code{ranlib}) of what modules
contain definitions for what names. contain definitions for what names.
@item -o @item -o
@itemx +print-file-name @itemx --print-file-name
@cindex input file name @cindex input file name
@cindex file name @cindex file name
@cindex source file name @cindex source file name
@ -654,19 +683,19 @@ rather than identifying the input file once only before all of its
symbols. symbols.
@item -r @item -r
@itemx +reverse-sort @itemx --reverse-sort
Reverse the sense of the sort (whether numeric or alphabetic); let the Reverse the sense of the sort (whether numeric or alphabetic); let the
last come first. last come first.
@item +target @var{bfdname} @item --target @var{bfdname}
@c @item +target @c @item --target
@cindex object code format @cindex object code format
Specify an object code format other than your system's default format. Specify an object code format other than your system's default format.
@xref{objdump}, for information on listing available formats. @xref{objdump}, for information on listing available formats.
@c FIXME what *does* +target/no arg do? @c FIXME what *does* --target/no arg do?
@item -u @item -u
@itemx +undefined-only @itemx --undefined-only
@cindex external symbols @cindex external symbols
@cindex undefined symbols @cindex undefined symbols
Display only undefined symbols (those external to each object file). Display only undefined symbols (those external to each object file).
@ -818,7 +847,7 @@ relocation entries. Using @samp{-x} is equivalent to specifying all of
stores it in the archive. The index lists each symbol defined by a stores it in the archive. The index lists each symbol defined by a
member of an archive that is a relocatable object file. member of an archive that is a relocatable object file.
You may use @samp{nm -s} or @samp{nm +print-armap} to list this index. You may use @samp{nm -s} or @samp{nm --print-armap} to list this index.
An archive with such an index speeds up linking to the library, and 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 allows routines in the library to call each other without regard to
@ -835,9 +864,9 @@ The GNU @code{ranlib} program is another form of GNU @code{ar}; running
@cindex section sizes @cindex section sizes
@smallexample @smallexample
size [ -A | -B | +format @var{compatibility} ] size [ -A | -B | --format @var{compatibility} ]
[ +help ] [ -d | -o | -x | +radix @var{number} ] [ --help ] [ -d | -o | -x | --radix @var{number} ]
[ +target @var{bfdname} ] [ -V | +version ] [ --target @var{bfdname} ] [ -V | --version ]
@var{objfiles}@dots{} @var{objfiles}@dots{}
@end smallexample @end smallexample
@ -853,21 +882,21 @@ The object files to be examined.
@item -A @item -A
@itemx -B @itemx -B
@itemx +format @var{compatibility} @itemx --format @var{compatibility}
@cindex size display format @cindex size display format
Using one of these options, you can choose whether the output from GNU Using one of these options, you can choose whether the output from GNU
@code{size} resembles output from System V @code{size} (using @samp{-A}, @code{size} resembles output from System V @code{size} (using @samp{-A},
or @samp{+format sysv}), or Berkeley @code{size} (using @samp{-B}, or or @samp{--format sysv}), or Berkeley @code{size} (using @samp{-B}, or
@samp{+format berkeley}). The default is the one-line format similar to @samp{--format berkeley}). The default is the one-line format similar to
Berkeley's. Berkeley's.
@c Bonus for doc-source readers: you can also say +format=strange (or @c Bonus for doc-source readers: you can also say --format=strange (or
@c anything else that starts with 's') for sysv, and +format=boring (or @c anything else that starts with 's') for sysv, and --format=boring (or
@c anything else that starts with 'b') for Berkeley. @c anything else that starts with 'b') for Berkeley.
Here is an example of the Berkeley (default) format of output from Here is an example of the Berkeley (default) format of output from
@code{size}: @code{size}:
@smallexample @smallexample
eg$ size +format Berkeley ranlib size eg$ size --format Berkeley ranlib size
text data bss dec hex filename text data bss dec hex filename
294880 81920 11592 388392 5ed28 ranlib 294880 81920 11592 388392 5ed28 ranlib
294880 81920 11888 388688 5ee50 size 294880 81920 11888 388688 5ee50 size
@ -877,7 +906,7 @@ text data bss dec hex filename
This is the same data, but displayed closer to System V conventions: This is the same data, but displayed closer to System V conventions:
@smallexample @smallexample
eg$ size +format SysV ranlib size eg$ size --format SysV ranlib size
ranlib : ranlib :
section size addr section size addr
.text 294880 8192 .text 294880 8192
@ -894,24 +923,24 @@ section size addr
Total 388688 Total 388688
@end smallexample @end smallexample
@item +help @item --help
Show a summary of acceptable arguments and options. Show a summary of acceptable arguments and options.
@item -d @item -d
@itemx -o @itemx -o
@itemx -x @itemx -x
@itemx +radix @var{number} @itemx --radix @var{number}
@cindex size number format @cindex size number format
@cindex radix for section sizes @cindex radix for section sizes
Using one of these options, you can control whether the size of each Using one of these options, you can control whether the size of each
section is given in decimal (@samp{-d}, or @samp{+radix 10}); octal section is given in decimal (@samp{-d}, or @samp{--radix 10}); octal
(@samp{-o}, or @samp{+radix 8}); or hexadecimal (@samp{-x}, or (@samp{-o}, or @samp{--radix 8}); or hexadecimal (@samp{-x}, or
@samp{+radix 16}). In @samp{+radix @var{number}}, only the three @samp{--radix 16}). In @samp{--radix @var{number}}, only the three
values (8, 10, 16) are supported. The total size is always given in two values (8, 10, 16) are supported. The total size is always given in two
radices; decimal and hexadecimal for @samp{-d} or @samp{-x} output, or radices; decimal and hexadecimal for @samp{-d} or @samp{-x} output, or
octal and hexadecimal if you're using @samp{-o}. octal and hexadecimal if you're using @samp{-o}.
@item +target @var{bfdname} @item --target @var{bfdname}
@cindex object code format @cindex object code format
You can specify a particular object-code format for @var{objfiles} as You can specify a particular object-code format for @var{objfiles} as
@var{bfdname}. This may not be necessary; @var{size} can @var{bfdname}. This may not be necessary; @var{size} can
@ -919,7 +948,7 @@ automatically recognize many formats. @xref{objdump}, for information
on listing available formats. on listing available formats.
@item -V @item -V
@itemx +version @itemx --version
Display version number information on @code{size} itself. Display version number information on @code{size} itself.
@end table @end table
@ -933,7 +962,11 @@ Display version number information on @code{size} itself.
@cindex symbols, discarding @cindex symbols, discarding
@smallexample @smallexample
strip [ -v ] @var{objfiles}@dots{} strip [-F @var{format} | --format=@var{format} ]
[-I @var{format} | --input-format=@var{format} ]
[-O @var{format} | --output-format=@var{format} ]
[ -v | --verbose ] [ -V | --version ]
@var{objfiles}@dots{}
@end smallexample @end smallexample
GNU @code{strip} discards all symbols from object files GNU @code{strip} discards all symbols from object files
@ -947,9 +980,42 @@ rather than writing modified copies under different names.
@end quotation @end quotation
@table @code @table @code
@item -I @var{format}
@itemx --input-format=@var{format}
Treat the original @var{objfiles} as files with the specified object
code format.
@item -O @var{format}
@itemx --output-format=@var{format}
Replace @var{objfiles} with files in the output format specified.
@item -F @var{format}
@itemx --format=@var{format}
Treat the original @var{objfiles} as files with the specified object
code format, and rewrite them in the same format.
@item -g
@itemx -S
@itemx --strip-debug
Remove debugging symbols only.
@item -x
@itemx --discard-all
Remove non-global symbols.
@item -X
@itemx --discard-locals
Remove compiler-generated local symbols.
(These usually start with @code{L} or @code{.}.)
@item -V
@itemx --version
Show version number.
@item -v @item -v
Verbose operation: list all object files modified. In the case of @itemx --verbose
archives, @samp{strip -v} lists all members of the archive. Verbose output: list all object files modified. In the case of
archives, @samp{strip -V} lists all members of the archive.
@end table @end table
@node Index, , strip, Top @node Index, , strip, Top