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