1 .\" Copyright (c) 1991 Free Software Foundation
2 .\" See section COPYING for conditions for redistribution
3 .TH objcopy 1 "June 1993" "cygnus support" "GNU Development Tools"
11 objcopy \- copy and translate object files
18 .RB "[\|" \-F\ \fIbfdname\fB\ |\ \-\-target=\fIbfdname\fR "\|]"
19 .RB "[\|" \-I\ \fIbfdname\fB\ |\ \-\-input\-target=\fIbfdname\fR "\|]"
20 .RB "[\|" \-O\ \fIbfdname\fB\ |\ \-\-output\-target=\fIbfdname\fR "\|]"
21 .RB "[\|" \-S\ |\ \-\-strip\-all\fR "\|]"
22 .RB "[\|" \-g\ |\ \-\-strip\-debug\fR "\|]"
23 .RB "[\|" \-x\ |\ \-\-discard\-all\fR "\|]"
24 .RB "[\|" \-X\ |\ \-\-discard\-locals\fR "\|]"
25 .RB "[\|" \-b\ \fIbyte\fP |\ \-\-byte=\fIbyte\fP "\|]"
26 .RB "[\|" \-i\ \fIinterleave\fP |\ \-\-interleave=\fIinterleave\fP "\|]"
27 .RB "[\|" \-v\ |\ \-\-verbose\fR "\|]"
28 .RB "[\|" \-V\ |\ \-\-version\fR "\|]"
29 .RB "[\|" \-\-help\fR "\|]"
31 .RB "[\|" outfile\fR "\|]"
35 utility copies the contents of an object file to another.
37 uses the GNU BFD Library to read and write the object files. It can
38 write the destination object file in a format different from that of
39 the source object file. The exact behavior of
41 is controlled by command-line options.
44 creates temporary files to do its translations and deletes them
47 uses BFD to do all its translation work; it knows about all the
48 formats BFD knows about, and thus is able to recognize most formats
49 without being told explicitly.
54 are the source and output files respectively. If you do not specify
57 creates a temporary file and destructively renames the result with the
58 name of the input file.
62 .B \-I \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname
63 Consider the source file's object format to be
65 rather than attempting to deduce it.
67 .B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname
68 Write the output file using the object format
71 .B \-F \fIbfdname\fR, \fB\-\-target=\fIbfdname
74 as the object format for both the input and the output file; i.e.
75 simply transfer data from source to destination with no translation.
77 .B \-S\fR, \fB\-\-strip\-all
78 Do not copy relocation and symbol information from the source file.
80 .B \-g\fR, \fB\-\-strip\-debug
81 Do not copy debugging symbols from the source file.
83 .B \-x\fR, \fB \-\-discard\-all
84 Do not copy non-global symbols from the source file.
86 .B \-X\fR, \fB\-\-discard\-locals
87 Do not copy compiler-generated local symbols. (These usually start
90 .B \-b \fIbyte\fR, \fB\-\-byte=\fIbyte
91 Keep only every \fIbyte\fPth byte of the input file (header data is
92 not affected). \fIbyte\fP can be in the range from 0 to the
93 interleave-1. This option is useful for creating files to program
94 ROMs. It is typically used with an srec output target.
96 .B \-i \fIinterleave\fR, \fB\-\-interleave=\fIinterleave
97 Only copy one out of every \fIinterleave\fP bytes. Which one to copy is
98 selected by the \fB\-b\fP or \fB\-\-byte\fP option. The default is 4.
99 The interleave is ignored if neither \fB\-b\fP nor \fB\-\-byte\fP is given.
101 .B \-v\fR, \fB\-\-verbose
102 Verbose output: list all object files modified. In the case of
103 archives, "\fBobjcopy \-V\fR" lists all members of the archive.
105 .B \-V\fR, \fB\-\-version
106 Show the version number of
111 Show a summary of the options to
115 .RB "`\|" binutils "\|'"
121 The GNU Binary Utilities\c
122 \&, Roland H. Pesch (June 1993).
125 Copyright (c) 1993 Free Software Foundation, Inc.
127 Permission is granted to make and distribute verbatim copies of
128 this manual provided the copyright notice and this permission notice
129 are preserved on all copies.
131 Permission is granted to copy and distribute modified versions of this
132 manual under the conditions for verbatim copying, provided that the
133 entire resulting derived work is distributed under the terms of a
134 permission notice identical to this one.
136 Permission is granted to copy and distribute translations of this
137 manual into another language, under the above conditions for modified
138 versions, except that this permission notice may be included in
139 translations approved by the Free Software Foundation instead of in
140 the original English.