mirror of
https://github.com/darlinghq/darling-gdb.git
synced 2024-11-25 05:00:01 +00:00
put objcopy in alphabetical order
This commit is contained in:
David MacKenzie
parent
9bebe50081
commit
eed5eeab82
@ -92,12 +92,12 @@ utilities (collectively version 2.2):
|
||||
@item ar
|
||||
Create, modify, and extract from archives
|
||||
|
||||
@item objcopy
|
||||
Copy and translate object files
|
||||
|
||||
@item nm
|
||||
List symbols from object files
|
||||
|
||||
@item objcopy
|
||||
Copy and translate object files
|
||||
|
||||
@item objdump
|
||||
Display information from object files
|
||||
|
||||
@ -117,9 +117,9 @@ Discard symbols
|
||||
|
||||
@menu
|
||||
* ar:: Create, modify, and extract from archives
|
||||
* objcopy:: Copy and translate object files
|
||||
* ld:(ld)Overview. Combine object and archive files
|
||||
* nm:: List symbols from object files
|
||||
* objcopy:: Copy and translate object files
|
||||
* objdump:: Display information from object files
|
||||
* ranlib:: Generate index to archive contents
|
||||
* size:: List section sizes and total size
|
||||
@ -129,7 +129,7 @@ Discard symbols
|
||||
* Index::
|
||||
@end menu
|
||||
|
||||
@node ar, objcopy, Top, Top
|
||||
@node ar, nm, Top, Top
|
||||
@chapter ar
|
||||
|
||||
@kindex ar
|
||||
@ -543,85 +543,6 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
|
||||
|
||||
@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
|
||||
@node 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}.
|
||||
@end iftex
|
||||
|
||||
@node nm, objdump, objcopy, Top
|
||||
@node nm, objcopy, ar, Top
|
||||
@chapter nm
|
||||
@cindex symbols
|
||||
@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.
|
||||
@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
|
||||
|
||||
@cindex object file information
|
||||
|
||||
Loading…
Reference in New Issue
Block a user