espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-23 03:29:47 +08:00
Code Issues Packages Projects Releases Wiki Activity

put objcopy in alphabetical order

Browse Source
This commit is contained in:
David MacKenzie
1993-10-30 02:24:39 +00:00
parent 9bebe50081
commit eed5eeab82
1 changed files with 86 additions and 86 deletions
Download Patch File Download Diff File Expand all files Collapse all files

172
binutils/binutils.texi
View File

@ -92,12 +92,12 @@ utilities (collectively version 2.2):
@item ar @item ar
Create, modify, and extract from archives Create, modify, and extract from archives
@item objcopy
Copy and translate object files
@item nm @item nm
List symbols from object files List symbols from object files
@item objcopy
Copy and translate object files
@item objdump @item objdump
Display information from object files Display information from object files
@ -117,9 +117,9 @@ Discard symbols
@menu @menu
* ar:: Create, modify, and extract from archives * ar:: Create, modify, and extract from archives
* objcopy:: Copy and translate object files
* ld:(ld)Overview. Combine object and archive files * ld:(ld)Overview. Combine object and archive files
* nm:: List symbols from object files * nm:: List symbols from object files
* objcopy:: Copy and translate object files
* objdump:: Display information from object files * objdump:: Display information from object files
* ranlib:: Generate index to archive contents * ranlib:: Generate index to archive contents
* size:: List section sizes and total size * size:: List section sizes and total size
@ -129,7 +129,7 @@ Discard symbols
* Index:: * Index::
@end menu @end menu
@node ar, objcopy, Top, Top @node ar, nm, Top, Top
@chapter ar @chapter ar
@kindex ar @kindex ar
@ -543,85 +543,6 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
@end table @end table
@node objcopy, nm, ar, Top
@chapter objcopy
@smallexample
objcopy [ -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 ] [ --help ]
@var{infile} [@var{outfile}]
@end smallexample
The GNU @code{objcopy} utility copies the contents of an object file to
another. @code{objcopy} uses the GNU BFD Library to read and write the
object files. It can write the destination object file in a format
different from that of the source object file. The exact behavior of
@code{objcopy} is controlled by command-line options.
@code{objcopy} creates temporary files to do its translations and
deletes them afterward. @code{objcopy} 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.
@xref{BFD,,BFD,ld.info,Using LD, the GNU linker}.
@table @code
@item @var{infile}
@itemx @var{outfile}
The source and output files respectively.
If you do not specify @var{outfile}, @code{objcopy} 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}
Consider the source file's object format to be @var{format}, rather than
attempting to deduce it.
@item -O @var{format}
@itemx --output-format=@var{format}
Write the output file using the object format @var{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
@itemx --strip-all
Do not copy relocation and symbol information from the source file.
@item -g
@itemx --strip-debug
Do not copy debugging symbols from the source file.
@item -x
@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 -X
@itemx --discard-locals
Do not copy compiler-generated local symbols.
(These usually start with @samp{L} or @samp{.}.)
@item -V
@itemx --version
Show the version number of @code{objcopy}.
@item -v
@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 @iftex
@node ld @node ld
@chapter ld @chapter ld
@ -631,7 +552,7 @@ The GNU linker @code{ld} is now described in a separate manual.
@xref{Top,, Overview,, Using LD: the GNU linker}. @xref{Top,, Overview,, Using LD: the GNU linker}.
@end iftex @end iftex
@node nm, objdump, objcopy, Top @node nm, objcopy, ar, Top
@chapter nm @chapter nm
@cindex symbols @cindex symbols
@kindex nm @kindex nm
@ -792,7 +713,86 @@ Show the version number of @code{nm} and exit.
Show a summary of the options to @code{nm} and exit. Show a summary of the options to @code{nm} and exit.
@end table @end table
@node objdump, ranlib, nm, Top @node objcopy, objdump, nm, Top
@chapter objcopy
@smallexample
objcopy [ -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 ] [ --help ]
@var{infile} [@var{outfile}]
@end smallexample
The GNU @code{objcopy} utility copies the contents of an object file to
another. @code{objcopy} uses the GNU BFD Library to read and write the
object files. It can write the destination object file in a format
different from that of the source object file. The exact behavior of
@code{objcopy} is controlled by command-line options.
@code{objcopy} creates temporary files to do its translations and
deletes them afterward. @code{objcopy} 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.
@xref{BFD,,BFD,ld.info,Using LD, the GNU linker}.
@table @code
@item @var{infile}
@itemx @var{outfile}
The source and output files respectively.
If you do not specify @var{outfile}, @code{objcopy} 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}
Consider the source file's object format to be @var{format}, rather than
attempting to deduce it.
@item -O @var{format}
@itemx --output-format=@var{format}
Write the output file using the object format @var{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
@itemx --strip-all
Do not copy relocation and symbol information from the source file.
@item -g
@itemx --strip-debug
Do not copy debugging symbols from the source file.
@item -x
@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 -X
@itemx --discard-locals
Do not copy compiler-generated local symbols.
(These usually start with @samp{L} or @samp{.}.)
@item -V
@itemx --version
Show the version number of @code{objcopy}.
@item -v
@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
@node objdump, ranlib, objcopy, Top
@chapter objdump @chapter objdump
@cindex object file information @cindex object file information