Commit | Line | Data |
---|---|---|
08ad9921 JO |
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" | |
4 | .de BP | |
5 | .sp | |
6 | .ti \-.2i | |
7 | \(** | |
8 | .. | |
9 | ||
10 | .SH NAME | |
11 | objcopy\(em\&copies and translates object files | |
12 | ||
13 | .SH SYNOPSIS | |
14 | .hy 0 | |
15 | .na | |
16 | .B objcopy | |
17 | .RS | |
18 | [ | |
19 | .B -F \fIformat\fB | --format=\fIformat\fB | |
20 | ] | |
21 | .br | |
22 | [ | |
23 | .B -I \fIformat\fB | --input-format=\fIformat\fB | |
24 | ] | |
25 | .br | |
26 | [ | |
27 | .B -O \fIformat\fB | --output-format=\fIformat\fB | |
28 | ] | |
29 | .br | |
30 | [ | |
31 | .B -S | --strip-all | |
32 | ] [ | |
33 | .B -g | --strip-debug | |
34 | ] | |
35 | .br | |
36 | [ | |
37 | .B -x | --discard-all | |
38 | ] [ | |
39 | .B -X | --discard-locals | |
40 | ] | |
41 | .br | |
42 | [ | |
43 | .B -v | --verbose | |
44 | ] [ | |
45 | .B -V | --version | |
46 | ] | |
47 | .br | |
48 | .I infile | |
49 | [ | |
50 | .I outfile | |
51 | ] | |
52 | .RE | |
53 | .SH DESCRIPTION | |
54 | The GNU | |
55 | .B objcopy | |
56 | utility copies the contents of an object file to another. | |
57 | .B objcopy | |
58 | uses the GNU BFD Library to read and write the object files. It can | |
59 | write the destination object file in a format different from that of | |
60 | the source object file. The exact behavior of | |
61 | .B objcopy | |
62 | is controlled by command-line options. | |
63 | ||
64 | .B objcopy | |
65 | creates temporary files to do its translations and deletes them | |
66 | afterward. | |
67 | .B objcopy | |
68 | uses BFD to do all its translation work; it knows about all the | |
69 | formats BFD knows about, and thus is able to recognize most formats | |
70 | without being told explicitly. | |
71 | ||
72 | .SH OPTIONS | |
73 | .TP 0.5i | |
74 | .I infile\fR,\fI outfile | |
75 | The source and output files respectively. If you do not specify | |
76 | .IR outfile , | |
77 | .B objcopy | |
78 | creates a temporary file and destructively renames the result with the | |
79 | name of the input file. | |
80 | .TP | |
81 | .B -I \fIformat\fB, --input-format=\fIformat\fB | |
82 | Consider the source file's object format to be | |
83 | .IR format , | |
84 | rather than attempting to deduce it. | |
85 | .TP | |
86 | .B -O \fIformat\fB, --output-format=\fIformat\fB | |
87 | Write the output file using the object format | |
88 | .IR format . | |
89 | .TP | |
90 | .B -F \fIformat\fB, --format=\fIformat\fB | |
91 | Use | |
92 | .I format | |
93 | as the object format for both the input and the output file; i.e. | |
94 | simply transfer data from source to destination with no translation. | |
95 | .TP | |
96 | .B -S, --strip-all | |
97 | Do not copy relocation and symbol information from the source file. | |
98 | .TP | |
99 | .B -g, --strip-debug | |
100 | Do not copy debugging symbols from the source file. | |
101 | .TP | |
102 | .B -x, --discard-all | |
103 | Do not copy non-global symbols from the source file. | |
104 | .TP | |
105 | .B -X, --discard-locals | |
106 | Do not copy compiler-generated local symbols. (These usually start | |
107 | with "L" or "."). | |
108 | .TP | |
109 | .B -v, --verbose | |
110 | Verbose output: list all object files modified. In the case of | |
111 | archives, "\fBobjcopy -V\fR" lists all members of the archive. | |
112 | .TP | |
113 | .B -V, --version | |
114 | Show the version number of | |
115 | .BR objcopy . | |
116 | .SH "SEE ALSO" | |
117 | .RB "`\|" binutils "\|'" | |
118 | entry in | |
119 | .B | |
120 | info\c | |
121 | \&; | |
122 | .I | |
123 | The GNU Binary Utilities\c | |
124 | \&, Roland H. Pesch (June 1993). | |
125 | ||
126 | .SH COPYING | |
127 | Copyright (c) 1993 Free Software Foundation, Inc. | |
128 | .PP | |
129 | Permission is granted to make and distribute verbatim copies of | |
130 | this manual provided the copyright notice and this permission notice | |
131 | are preserved on all copies. | |
132 | .PP | |
133 | Permission is granted to copy and distribute modified versions of this | |
134 | manual under the conditions for verbatim copying, provided that the | |
135 | entire resulting derived work is distributed under the terms of a | |
136 | permission notice identical to this one. | |
137 | .PP | |
138 | Permission is granted to copy and distribute translations of this | |
139 | manual into another language, under the above conditions for modified | |
140 | versions, except that this permission notice may be included in | |
141 | translations approved by the Free Software Foundation instead of in | |
142 | the original English. |