Commit | Line | Data |
---|---|---|
df22f469 RP |
1 | .\" Copyright (c) 1991 Free Software Foundation |
2 | .\" See section COPYING for conditions for redistribution | |
df22f469 RP |
3 | .TH strip 1 "5 November 1991" "cygnus support" "GNU Development Tools" |
4 | .de BP | |
5 | .sp | |
6 | .ti \-.2i | |
7 | \(** | |
8 | .. | |
9 | ||
10 | .SH NAME | |
938fa52b | 11 | strip \- Discard symbols from object files. |
df22f469 RP |
12 | |
13 | .SH SYNOPSIS | |
0aca460e ILT |
14 | .hy 0 |
15 | .na | |
16 | .TP | |
1f72cab1 | 17 | .B strip |
dff604a7 ILT |
18 | .RB "[\|" \-F\ \fIbfdname\fR\ |\ \fB\-\-target=\fIbfdname\fP "\|]" |
19 | .RB "[\|" \-I\ \fIbfdname\fR\ |\ \fB\-\-input\-target=\fIbfdname\fP "\|]" | |
20 | .RB "[\|" \-O\ \fIbfdname\fR\ |\ \fB\-\-output\-target=\fIbfdname\fP "\|]" | |
21 | .RB "[\|" \-R\ \fIsectionname\fR\ |\ \fB\-\-remove\-section=\fIsectionname\fP "\|]" | |
22 | .RB "[\|" \-s\fR\ |\ \fB\-\-strip\-all "\|]" | |
23 | .RB "[\|" \-S\fR\ |\ \fB\-g\fR\ |\ \fB\-\-strip\-debug "\|]" | |
9135e5f8 | 24 | .RB "[\|" \-\-strip\-unneeded\fR "\|]" |
dff604a7 ILT |
25 | .RB "[\|" \-x\fR\ |\ \fB\-\-discard\-all "\|]" |
26 | .RB "[\|" \-X\fR\ |\ \fB\-\-discard\-locals "\|]" | |
27 | .RB "[\|" \-K\ \fIsymbolname\fR\ |\ \fB\-\-keep\-symbol=\fIsymbolname\fR "\|]" | |
28 | .RB "[\|" \-N\ \fIsymbolname\fR\ |\ \fB\-\-strip\-symbol=\fIsymbolname\fR "\|]" | |
29 | .RB "[\|" \-v\fR\ |\ \fB\-\-verbose "\|]" | |
30 | .RB "[\|" \-V\fR\ |\ \fB\-\-version "\|]" | |
31 | .RB "[\|" \-V\fR\ |\ \fB\-\-help "\|]" | |
1f72cab1 | 32 | .I objfile\c |
df22f469 | 33 | \&.\|.\|. |
1815e42c | 34 | |
df22f469 | 35 | .SH DESCRIPTION |
b26ac613 DM |
36 | GNU |
37 | .B strip | |
38 | discards all symbols from the object files | |
39 | .IR objfile . | |
40 | The list of object files may include archives. | |
41 | At least one object file must be given. | |
df22f469 | 42 | |
b26ac613 DM |
43 | .P |
44 | .B strip | |
45 | modifies the files named in its argument, | |
df22f469 RP |
46 | rather than writing modified copies under different names. |
47 | ||
48 | .SH OPTIONS | |
1f72cab1 | 49 | .TP |
eae04238 | 50 | .B "\-F \fIbfdname" |
b26ac613 | 51 | .TP |
eae04238 | 52 | .B "\-\-target=\fIbfdname" |
1f72cab1 | 53 | Treat the original \fIobjfile\fP as a file with the object |
eae04238 | 54 | code format \fIbfdname\fP, and rewrite it in the same format. |
1f72cab1 DM |
55 | |
56 | .TP | |
b26ac613 DM |
57 | .B \-\-help |
58 | Show a summary of the options to | |
59 | .B strip | |
60 | and exit. | |
61 | ||
62 | .TP | |
eae04238 | 63 | .B "\-I \fIbfdname |
b26ac613 | 64 | .TP |
eae04238 | 65 | .B "\-\-input\-target=\fIbfdname" |
1f72cab1 | 66 | Treat the original \fIobjfile\fP as a file with the object |
eae04238 | 67 | code format \fIbfdname\fP. |
1f72cab1 DM |
68 | |
69 | .TP | |
eae04238 | 70 | .B "\-O \fIbfdname\fP" |
b26ac613 | 71 | .TP |
eae04238 DM |
72 | .B "\-\-output\-target=\fIbfdname" |
73 | Replace \fIobjfile\fP with a file in the output format \fIbfdname\fP. | |
1f72cab1 | 74 | |
0aca460e ILT |
75 | .TP |
76 | .B "\-R \fIsectionname\fP" | |
77 | .TP | |
78 | .B "\-\-remove\-section=\fIsectionname" | |
79 | Remove the named section from the file. This option may be given more | |
80 | than once. Note that using this option inappropriately may make the | |
81 | object file unusable. | |
82 | ||
1f72cab1 | 83 | .TP |
b26ac613 DM |
84 | .B \-s |
85 | .TP | |
86 | .B \-\-strip\-all | |
1f72cab1 DM |
87 | Remove all symbols. |
88 | ||
89 | .TP | |
b26ac613 DM |
90 | .B \-S |
91 | .TP | |
92 | .B -g | |
93 | .TP | |
94 | .B \-\-strip\-debug | |
1f72cab1 DM |
95 | Remove debugging symbols only. |
96 | ||
9135e5f8 ILT |
97 | .TP |
98 | .B \-\-strip\-unneeded | |
99 | Strip all symbols that are not needed for relocation processing. | |
100 | ||
29c0d15c ILT |
101 | .TP |
102 | .B \-N \fIsymbolname\fR | |
103 | .TP | |
104 | .B \-\-strip\-symbol=\fIsymbolname | |
105 | Remove symbol \fIsymbolname\fP from the source file. This option | |
106 | may be given more than once, and may be combined with other strip | |
107 | options. | |
108 | ||
1f72cab1 | 109 | .TP |
b26ac613 DM |
110 | .B \-x |
111 | .TP | |
112 | .B \-\-discard\-all | |
1f72cab1 DM |
113 | Remove non-global symbols. |
114 | ||
115 | .TP | |
116 | .B "\-X \-\-discard\-locals" | |
117 | Remove compiler-generated local symbols. | |
118 | (These usually start with ``L'' or ``.''.) | |
119 | ||
dff604a7 ILT |
120 | .TP |
121 | .B \-K \fIsymbolname\fR, \fB\-\-keep\-symbol=\fIsymbolname | |
122 | Copy only symbol \fIsymbolname\fP from the source file. This option | |
123 | may be given more than once. | |
124 | ||
125 | .TP | |
126 | .B \-N \fIsymbolname\fR, \fB\-\-strip\-symbol=\fIsymbolname | |
127 | Do not copy symbol \fIsymbolname\fP from the source file. This option | |
128 | may be given more than once, and may be combined with strip options | |
129 | other than \fB\-K\fR. | |
130 | ||
1f72cab1 | 131 | .TP |
b26ac613 DM |
132 | .B \-v |
133 | .TP | |
134 | .B \-\-verbose | |
1f72cab1 | 135 | Verbose output: list all object files modified. In the case of |
b26ac613 DM |
136 | archives, |
137 | .B "strip \-V" | |
138 | lists all members of the archive. | |
1f72cab1 DM |
139 | |
140 | .TP | |
b26ac613 DM |
141 | .B \-V |
142 | .TP | |
143 | .B \-\-version | |
144 | Show the version number for \fBstrip\fP and exit. | |
df22f469 RP |
145 | |
146 | .SH "SEE ALSO" | |
147 | .RB "`\|" binutils "\|'" | |
148 | entry in | |
b26ac613 DM |
149 | .BR info ; |
150 | .IR "The GNU Binary Utilities , | |
151 | Roland H. Pesch (October 1991). | |
df22f469 RP |
152 | |
153 | .SH COPYING | |
154 | Copyright (c) 1991 Free Software Foundation, Inc. | |
155 | .PP | |
156 | Permission is granted to make and distribute verbatim copies of | |
157 | this manual provided the copyright notice and this permission notice | |
158 | are preserved on all copies. | |
159 | .PP | |
160 | Permission is granted to copy and distribute modified versions of this | |
161 | manual under the conditions for verbatim copying, provided that the | |
162 | entire resulting derived work is distributed under the terms of a | |
163 | permission notice identical to this one. | |
164 | .PP | |
165 | Permission is granted to copy and distribute translations of this | |
166 | manual into another language, under the above conditions for modified | |
167 | versions, except that this permission notice may be included in | |
168 | translations approved by the Free Software Foundation instead of in | |
169 | the original English. |