binutils/strip.1

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