0aca460e7c
* objcopy.c (struct section_list): Define. (remove_sections): New static variable. (strip_options, copy_options): Add remove-section. (copy_usage, strip_usage): Mention -R and --remove-section. (setup_section): If section is in remove_sections list, ignore it. (copy_section): Likewise. (strip_main, copy_main): Handle -R. * binutils.texi, objcopy.1, strip.1: Document new options.
146 lines
4.7 KiB
Groff
146 lines
4.7 KiB
Groff
.\" Copyright (c) 1991 Free Software Foundation
|
|
.\" See section COPYING for conditions for redistribution
|
|
.TH objcopy 1 "June 1993" "cygnus support" "GNU Development Tools"
|
|
.de BP
|
|
.sp
|
|
.ti \-.2i
|
|
\(**
|
|
..
|
|
|
|
.SH NAME
|
|
objcopy \- copy and translate object files
|
|
|
|
.SH SYNOPSIS
|
|
.hy 0
|
|
.na
|
|
.TP
|
|
.B objcopy
|
|
.RB "[\|" \-F\ \fIbfdname\fB\ |\ \-\-target=\fIbfdname\fR "\|]"
|
|
.RB "[\|" \-I\ \fIbfdname\fB\ |\ \-\-input\-target=\fIbfdname\fR "\|]"
|
|
.RB "[\|" \-O\ \fIbfdname\fB\ |\ \-\-output\-target=\fIbfdname\fR "\|]"
|
|
.RB "[\|" \-R\ \fIsectionname\fB\ |\ \-\-remove\-section=\fIsectionname\fR "\|]"
|
|
.RB "[\|" \-S\ |\ \-\-strip\-all\fR "\|]"
|
|
.RB "[\|" \-g\ |\ \-\-strip\-debug\fR "\|]"
|
|
.RB "[\|" \-x\ |\ \-\-discard\-all\fR "\|]"
|
|
.RB "[\|" \-X\ |\ \-\-discard\-locals\fR "\|]"
|
|
.RB "[\|" \-b\ \fIbyte\fP |\ \-\-byte=\fIbyte\fP "\|]"
|
|
.RB "[\|" \-i\ \fIinterleave\fP |\ \-\-interleave=\fIinterleave\fP "\|]"
|
|
.RB "[\|" \-v\ |\ \-\-verbose\fR "\|]"
|
|
.RB "[\|" \-V\ |\ \-\-version\fR "\|]"
|
|
.RB "[\|" \-\-help\fR "\|]"
|
|
.B infile
|
|
.RB "[\|" outfile\fR "\|]"
|
|
.SH DESCRIPTION
|
|
The GNU
|
|
.B objcopy
|
|
utility copies the contents of an object file to another.
|
|
.B 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
|
|
.B objcopy
|
|
is controlled by command-line options.
|
|
.PP
|
|
.B objcopy
|
|
creates temporary files to do its translations and deletes them
|
|
afterward.
|
|
.B 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.
|
|
.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 \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname
|
|
Consider the source file's object format to be
|
|
.IR bfdname ,
|
|
rather than attempting to deduce it.
|
|
.TP
|
|
.B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname
|
|
Write the output file using the object format
|
|
.IR bfdname .
|
|
.TP
|
|
.B \-F \fIbfdname\fR, \fB\-\-target=\fIbfdname
|
|
Use
|
|
.I bfdname
|
|
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 \-R \fIsectionname\fR, \fB\-\-remove-section=\fIsectionname
|
|
Remove the named section from the file. This option may be given more
|
|
than once. Note that using this option inappropriately may make the
|
|
output file unusable.
|
|
.TP
|
|
.B \-S\fR, \fB\-\-strip\-all
|
|
Do not copy relocation and symbol information from the source file.
|
|
.TP
|
|
.B \-g\fR, \fB\-\-strip\-debug
|
|
Do not copy debugging symbols from the source file.
|
|
.TP
|
|
.B \-x\fR, \fB \-\-discard\-all
|
|
Do not copy non-global symbols from the source file.
|
|
.TP
|
|
.B \-X\fR, \fB\-\-discard\-locals
|
|
Do not copy compiler-generated local symbols. (These usually start
|
|
with "L" or ".").
|
|
.TP
|
|
.B \-b \fIbyte\fR, \fB\-\-byte=\fIbyte
|
|
Keep only every \fIbyte\fPth byte of the input file (header data is
|
|
not affected). \fIbyte\fP can be in the range from 0 to the
|
|
interleave-1. This option is useful for creating files to program
|
|
ROMs. It is typically used with an srec output target.
|
|
.TP
|
|
.B \-i \fIinterleave\fR, \fB\-\-interleave=\fIinterleave
|
|
Only copy one out of every \fIinterleave\fP bytes. Which one to copy is
|
|
selected by the \fB\-b\fP or \fB\-\-byte\fP option. The default is 4.
|
|
The interleave is ignored if neither \fB\-b\fP nor \fB\-\-byte\fP is given.
|
|
.TP
|
|
.B \-v\fR, \fB\-\-verbose
|
|
Verbose output: list all object files modified. In the case of
|
|
archives, "\fBobjcopy \-V\fR" lists all members of the archive.
|
|
.TP
|
|
.B \-V\fR, \fB\-\-version
|
|
Show the version number of
|
|
.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
|
|
.B
|
|
info\c
|
|
\&;
|
|
.I
|
|
The GNU Binary Utilities\c
|
|
\&, Roland H. Pesch (June 1993).
|
|
|
|
.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.
|