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