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 "[\|" \-v\fR\ |\ \fB\-\-verbose "\|]"
  30 .RB "[\|" \-V\fR\ |\ \fB\-\-version "\|]"
  31 .RB "[\|" \-V\fR\ |\ \fB\-\-help "\|]"
  32 .I objfile\c
  33 \&.\|.\|.
  34
  35 .SH DESCRIPTION
  36 GNU
  37 .B strip
  38 discards all symbols from the object files
  39 .IR objfile .
  40 The list of object files may include archives.
  41 At least one object file must be given.
  42
  43 .P
  44 .B strip
  45 modifies the files named in its argument,
  46 rather than writing modified copies under different names.
  47
  48 .SH OPTIONS
  49 .TP
  50 .B "\-F \fIbfdname"
  51 .TP
  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.
  55
  56 .TP
  57 .B \-\-help
  58 Show a summary of the options to
  59 .B strip
  60 and exit.
  61
  62 .TP
  63 .B "\-I \fIbfdname
  64 .TP
  65 .B "\-\-input\-target=\fIbfdname"
  66 Treat the original \fIobjfile\fP as a file with the object
  67 code format \fIbfdname\fP.
  68
  69 .TP
  70 .B "\-O \fIbfdname\fP"
  71 .TP
  72 .B "\-\-output\-target=\fIbfdname"
  73 Replace \fIobjfile\fP with a file in the output format \fIbfdname\fP.
  74
  75 .TP
  76 .B "\-R \fIsectionname\fP"
  77 .TP
  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
  81 object file unusable.
  82
  83 .TP
  84 .B \-s
  85 .TP
  86 .B \-\-strip\-all
  87 Remove all symbols.
  88
  89 .TP
  90 .B \-S
  91 .TP
  92 .B \-g
  93 .TP
  94 .B \-\-strip\-debug
  95 Remove debugging symbols only.
  96
  97 .TP
  98 .B \-\-strip\-unneeded
  99 Strip all symbols that are not needed for relocation processing.
 100
 101 .TP
 102 .B \-N \fIsymbolname\fR
 103 .TP
 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
 107 options.
 108
 109 .TP
 110 .B \-x
 111 .TP
 112 .B \-\-discard\-all
 113 Remove non-global symbols.
 114
 115 .TP
 116 .B \-X
 117 .TP
 118 .B \-\-discard\-locals
 119 Remove compiler-generated local symbols.
 120 (These usually start with ``L'' or ``.''.)
 121
 122 .TP
 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.
 126
 127 .TP
 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.
 132
 133 .TP
 134 .B \-v
 135 .TP
 136 .B \-\-verbose
 137 Verbose output: list all object files modified.  In the case of
 138 archives,
 139 .B "strip \-V"
 140 lists all members of the archive.
 141
 142 .TP
 143 .B \-V
 144 .TP
 145 .B \-\-version
 146 Show the version number for \fBstrip\fP and exit.
 147
 148 .SH "SEE ALSO"
 149 .RB "`\|" binutils "\|'"
 150 entry in
 151 .BR info ;
 152 .IR "The GNU Binary Utilities" ,
 153 Roland H. Pesch (October 1991).
 154
 155 .SH COPYING
 156 Copyright (c) 1991 Free Software Foundation, Inc.
 157 .PP
 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.
 161 .PP
 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.
 166 .PP
 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.