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.
116 .B "\-X \-\-discard\-locals"
117 Remove compiler-generated local symbols.
118 (These usually start with ``L'' or ``.''.)
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.
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.
135 Verbose output: list all object files modified. In the case of
138 lists all members of the archive.
144 Show the version number for \fBstrip\fP and exit.
147 .RB "`\|" binutils "\|'"
150 .IR "The GNU Binary Utilities ,
151 Roland H. Pesch (October 1991).
154 Copyright (c) 1991 Free Software Foundation, Inc.
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.
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.
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.