binutils/strip.1

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