Commit | Line | Data |
---|---|---|
df22f469 RP |
1 | .\" Copyright (c) 1991 Free Software Foundation |
2 | .\" See section COPYING for conditions for redistribution | |
3 | .\" $Id$ | |
4 | .TH strip 1 "5 November 1991" "cygnus support" "GNU Development Tools" | |
5 | .de BP | |
6 | .sp | |
7 | .ti \-.2i | |
8 | \(** | |
9 | .. | |
10 | ||
11 | .SH NAME | |
12 | strip\(em\&Discard symbols from object files. | |
13 | ||
14 | .SH SYNOPSIS | |
15 | .hy 0 | |
16 | .na | |
17 | .TP | |
18 | .B strip | |
19 | .RB "[\|" \-s | +strip-all "\|]" | |
20 | .RB "[\|" \-g | \-S | +strip-debug\c | |
21 | \|] | |
22 | .RB "[\|" \-x | +discard-all "\|]" | |
23 | .RB "[\|" \-X | +discard-locals "\|]" | |
24 | .RB "[\|" "\-T\ "\c | |
25 | .I bfdname\c | |
26 | \&\|] | |
27 | .I objfiles\c | |
28 | \&.\|.\|. | |
29 | .ad b | |
30 | .hy 1 | |
31 | .SH DESCRIPTION | |
32 | GNU \c | |
33 | .B strip\c | |
34 | \& will discard all symbols from object files | |
35 | \c | |
36 | .I objfiles\c | |
37 | \&, if no options are specified; or only certain symbols, | |
38 | depending on its command-line options. | |
39 | ||
40 | \c | |
41 | .B strip\c | |
42 | \& will not execute unless at least one object file is listed. | |
43 | ||
44 | .I WARNING:\c | |
45 | \& \c | |
46 | .B strip\c | |
47 | \& modifies the files named in its argument, | |
48 | rather than writing modified copies under different names. | |
49 | ||
50 | .SH OPTIONS | |
51 | The long and short forms of options, shown here as alternatives, are | |
52 | equivalent. | |
53 | ||
54 | .TP | |
55 | .B \-s | |
56 | .TP | |
57 | .B +strip-all | |
58 | This is the default case: strip all symbol entries from \c | |
59 | .I objfiles\c | |
60 | \&. | |
61 | ||
62 | .TP | |
63 | .B \-g | |
64 | .TP | |
65 | .B \-S | |
66 | .TP | |
67 | .B +strip-debug | |
68 | Discard only debugging symbol information from \c | |
69 | .I objfiles\c | |
70 | \&. | |
71 | ||
72 | .TP | |
73 | .B \-x | |
74 | .TP | |
75 | .B +discard-all | |
76 | Discard all symbols local to each file in \c | |
77 | .I objfiles\c | |
78 | \&. | |
79 | \c | |
80 | .I WARNING:\c | |
81 | \& Note that \c | |
82 | .B +discard-all\c | |
83 | \& discards only \c | |
84 | .I local\c | |
85 | \& | |
86 | symbols, in spite of its name. | |
87 | ||
88 | .TP | |
89 | .B \-X | |
90 | .TP | |
91 | .B +discard-locals | |
92 | Discard local symbols starting with `\|\c | |
93 | .B L\c | |
94 | \|' from each file in | |
95 | \c | |
96 | .I objfiles\c | |
97 | \&. (Some compilers produce internally-used symbols that | |
98 | begin with `\|\c | |
99 | .B L\c | |
100 | \|'.) | |
101 | ||
102 | .TP | |
103 | .BI "-T " "bfdname"\c | |
104 | \& | |
105 | You can specify a particular object-code format \c | |
106 | .I bfdname\c | |
107 | \& for | |
108 | \c | |
109 | .I objfiles\c | |
110 | \&. This may not be necessary; \c | |
111 | .I strip\c | |
112 | \& can automatically | |
113 | recognize many formats. for information on listing | |
114 | available formats. | |
115 | .PP | |
116 | ||
117 | .SH "SEE ALSO" | |
118 | .RB "`\|" binutils "\|'" | |
119 | entry in | |
120 | .B | |
121 | info\c | |
122 | \&; | |
123 | .I | |
124 | The GNU Binary Utilities\c | |
125 | \&, Roland H. Pesch (October 1991). | |
126 | ||
127 | .SH COPYING | |
128 | Copyright (c) 1991 Free Software Foundation, Inc. | |
129 | .PP | |
130 | Permission is granted to make and distribute verbatim copies of | |
131 | this manual provided the copyright notice and this permission notice | |
132 | are preserved on all copies. | |
133 | .PP | |
134 | Permission is granted to copy and distribute modified versions of this | |
135 | manual under the conditions for verbatim copying, provided that the | |
136 | entire resulting derived work is distributed under the terms of a | |
137 | permission notice identical to this one. | |
138 | .PP | |
139 | Permission is granted to copy and distribute translations of this | |
140 | manual into another language, under the above conditions for modified | |
141 | versions, except that this permission notice may be included in | |
142 | translations approved by the Free Software Foundation instead of in | |
143 | the original English. |