1 .\" Copyright (c) 1991 Free Software Foundation
2 .\" See section COPYING for conditions for redistribution
3 .TH strip 1 "5 November 1991" "cygnus support" "GNU Development Tools"
11 strip \- Discard symbols from object files.
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 "\|]"
24 .RB "[\|" \-\-strip\-unneeded\fR "\|]"
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 "\|]"
38 discards all symbols from the object files
40 The list of object files may include archives.
41 At least one object file must be given.
45 modifies the files named in its argument,
46 rather than writing modified copies under different names.
52 .B "\-\-target=\fIbfdname"
53 Treat the original \fIobjfile\fP as a file with the object
54 code format \fIbfdname\fP, and rewrite it in the same format.
58 Show a summary of the options to
65 .B "\-\-input\-target=\fIbfdname"
66 Treat the original \fIobjfile\fP as a file with the object
67 code format \fIbfdname\fP.
70 .B "\-O \fIbfdname\fP"
72 .B "\-\-output\-target=\fIbfdname"
73 Replace \fIobjfile\fP with a file in the output format \fIbfdname\fP.
76 .B "\-R \fIsectionname\fP"
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
95 Remove debugging symbols only.
98 .B \-\-strip\-unneeded
99 Strip all symbols that are not needed for relocation processing.
102 .B \-N \fIsymbolname\fR
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
113 Remove non-global symbols.
118 .B \-\-discard\-locals
119 Remove compiler-generated local symbols.
120 (These usually start with ``L'' or ``.''.)
123 .B \-K \fIsymbolname\fR, \fB\-\-keep\-symbol=\fIsymbolname
124 Copy only symbol \fIsymbolname\fP from the source file. This option
125 may be given more than once.
128 .B \-N \fIsymbolname\fR, \fB\-\-strip\-symbol=\fIsymbolname
129 Do not copy symbol \fIsymbolname\fP from the source file. This option
130 may be given more than once, and may be combined with strip options
131 other than \fB\-K\fR.
137 Verbose output: list all object files modified. In the case of
140 lists all members of the archive.
146 Show the version number for \fBstrip\fP and exit.
149 .RB "`\|" binutils "\|'"
152 .IR "The GNU Binary Utilities" ,
153 Roland H. Pesch (October 1991).
156 Copyright (c) 1991 Free Software Foundation, Inc.
158 Permission is granted to make and distribute verbatim copies of
159 this manual provided the copyright notice and this permission notice
160 are preserved on all copies.
162 Permission is granted to copy and distribute modified versions of this
163 manual under the conditions for verbatim copying, provided that the
164 entire resulting derived work is distributed under the terms of a
165 permission notice identical to this one.
167 Permission is granted to copy and distribute translations of this
168 manual into another language, under the above conditions for modified
169 versions, except that this permission notice may be included in
170 translations approved by the Free Software Foundation instead of in
171 the original English.