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 | |
1f72cab1 DM |
14 | .B strip |
15 | .RB "[\|" "\-F \fIformat\fP" | \-\-format=\fIformat\fP | \-\-target=\fIformat\fP "\|]" | |
16 | .RB "[\|" "\-I \fIformat\fP" | \-\-input\-format=\fIformat\fP "\|]" | |
17 | .RB "[\|" "\-O \fIformat\fP" | \-\-output\-format=\fIformat\fP "\|]" | |
18 | .RB "[\|" \-s | \-\-strip\-all "\|]" | |
19 | .RB "[\|" \-S | -g | \-\-strip\-debug "\|]" | |
20 | .RB "[\|" \-x | \-\-discard\-all "\|]" | |
21 | .RB "[\|" \-X | \-\-discard\-locals "\|]" | |
22 | .RB "[\|" \-v | \-\-verbose "\|]" | |
23 | .RB "[\|" \-V | \-\-version "\|]" | |
b26ac613 | 24 | .RB "[\|" \-V | \-\-help "\|]" |
1f72cab1 | 25 | .I objfile\c |
df22f469 | 26 | \&.\|.\|. |
1815e42c | 27 | |
df22f469 | 28 | .SH DESCRIPTION |
b26ac613 DM |
29 | GNU |
30 | .B strip | |
31 | discards all symbols from the object files | |
32 | .IR objfile . | |
33 | The list of object files may include archives. | |
34 | At least one object file must be given. | |
df22f469 | 35 | |
b26ac613 DM |
36 | .P |
37 | .B strip | |
38 | modifies the files named in its argument, | |
df22f469 RP |
39 | rather than writing modified copies under different names. |
40 | ||
41 | .SH OPTIONS | |
1f72cab1 | 42 | .TP |
b26ac613 DM |
43 | .B "\-F \fIformat" |
44 | .TP | |
45 | .B "\-\-format=\fIformat" | |
46 | .TP | |
47 | .B "\-\-target=\fIformat" | |
1f72cab1 DM |
48 | Treat the original \fIobjfile\fP as a file with the object |
49 | code format \fIformat\fP, and rewrite it in the same format. | |
50 | ||
51 | .TP | |
b26ac613 DM |
52 | .B \-\-help |
53 | Show a summary of the options to | |
54 | .B strip | |
55 | and exit. | |
56 | ||
57 | .TP | |
58 | .B "\-I \fIformat | |
59 | .TP | |
60 | .B "\-\-input\-format=\fIformat" | |
1f72cab1 DM |
61 | Treat the original \fIobjfile\fP as a file with the object |
62 | code format \fIformat\fP. | |
63 | ||
64 | .TP | |
b26ac613 DM |
65 | .B "\-O \fIformat\fP" |
66 | .TP | |
67 | .B "\-\-output\-format=\fIformat" | |
1f72cab1 DM |
68 | Replace \fIobjfile\fP with a file in the output format \fIformat\fP. |
69 | ||
70 | .TP | |
b26ac613 DM |
71 | .B \-s |
72 | .TP | |
73 | .B \-\-strip\-all | |
1f72cab1 DM |
74 | Remove all symbols. |
75 | ||
76 | .TP | |
b26ac613 DM |
77 | .B \-S |
78 | .TP | |
79 | .B -g | |
80 | .TP | |
81 | .B \-\-strip\-debug | |
1f72cab1 DM |
82 | Remove debugging symbols only. |
83 | ||
84 | .TP | |
b26ac613 DM |
85 | .B \-x |
86 | .TP | |
87 | .B \-\-discard\-all | |
1f72cab1 DM |
88 | Remove non-global symbols. |
89 | ||
90 | .TP | |
91 | .B "\-X \-\-discard\-locals" | |
92 | Remove compiler-generated local symbols. | |
93 | (These usually start with ``L'' or ``.''.) | |
94 | ||
95 | .TP | |
b26ac613 DM |
96 | .B \-v |
97 | .TP | |
98 | .B \-\-verbose | |
1f72cab1 | 99 | Verbose output: list all object files modified. In the case of |
b26ac613 DM |
100 | archives, |
101 | .B "strip \-V" | |
102 | lists all members of the archive. | |
1f72cab1 DM |
103 | |
104 | .TP | |
b26ac613 DM |
105 | .B \-V |
106 | .TP | |
107 | .B \-\-version | |
108 | Show the version number for \fBstrip\fP and exit. | |
df22f469 RP |
109 | |
110 | .SH "SEE ALSO" | |
111 | .RB "`\|" binutils "\|'" | |
112 | entry in | |
b26ac613 DM |
113 | .BR info ; |
114 | .IR "The GNU Binary Utilities , | |
115 | Roland H. Pesch (October 1991). | |
df22f469 RP |
116 | |
117 | .SH COPYING | |
118 | Copyright (c) 1991 Free Software Foundation, Inc. | |
119 | .PP | |
120 | Permission is granted to make and distribute verbatim copies of | |
121 | this manual provided the copyright notice and this permission notice | |
122 | are preserved on all copies. | |
123 | .PP | |
124 | Permission is granted to copy and distribute modified versions of this | |
125 | manual under the conditions for verbatim copying, provided that the | |
126 | entire resulting derived work is distributed under the terms of a | |
127 | permission notice identical to this one. | |
128 | .PP | |
129 | Permission is granted to copy and distribute translations of this | |
130 | manual into another language, under the above conditions for modified | |
131 | versions, except that this permission notice may be included in | |
132 | translations approved by the Free Software Foundation instead of in | |
133 | the original English. |