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\(em\&Discard symbols from object files.
  12
  13 .SH SYNOPSIS
  14 .hy 0
  15 .na
  16 .TP
  17 .B strip
  18 .RB "[\|" \-s | +strip-all "\|]"
  19 .RB "[\|" \-g | \-S | +strip-debug\c
  20 \|]
  21 .RB "[\|" \-x | +discard-all "\|]"
  22 .RB "[\|" \-X | +discard-locals "\|]"
  23 .RB "[\|" "\-T\ "\c
  24 .I bfdname\c
  25 \&\|]
  26 .I objfiles\c
  27 \&.\|.\|.
  28 .ad b
  29 .hy 1
  30 .SH DESCRIPTION
  31 GNU \c
  32 .B strip\c
  33 \& will discard all symbols from object files
  34 \c
  35 .I objfiles\c
  36 \&, if no options are specified; or only certain symbols,
  37 depending on its command-line options.
  38
  39 \c
  40 .B strip\c
  41 \& will not execute unless at least one object file is listed.
  42
  43 .I WARNING:\c
  44 \& \c
  45 .B strip\c
  46 \& modifies the files named in its argument,
  47 rather than writing modified copies under different names.
  48
  49 .SH OPTIONS
  50 The long and short forms of options, shown here as alternatives, are
  51 equivalent.
  52
  53 .TP
  54 .B \-s
  55 .TP
  56 .B +strip-all
  57 This is the default case: strip all symbol entries from \c
  58 .I objfiles\c
  59 \&.
  60
  61 .TP
  62 .B \-g
  63 .TP
  64 .B \-S
  65 .TP
  66 .B +strip-debug
  67 Discard only debugging symbol information from \c
  68 .I objfiles\c
  69 \&.
  70
  71 .TP
  72 .B \-x
  73 .TP
  74 .B +discard-all
  75 Discard all symbols local to each file in \c
  76 .I objfiles\c
  77 \&.
  78 \c
  79 .I WARNING:\c
  80 \& Note that \c
  81 .B +discard-all\c
  82 \& discards only \c
  83 .I local\c
  84 \&
  85 symbols, in spite of its name.
  86
  87 .TP
  88 .B \-X
  89 .TP
  90 .B +discard-locals
  91 Discard local symbols starting with `\|\c
  92 .B L\c
  93 \|' from each file in
  94 \c
  95 .I objfiles\c
  96 \&.  (Some compilers produce internally-used symbols that
  97 begin with `\|\c
  98 .B L\c
  99 \|'.)
 100
 101 .TP
 102 .BI "-T " "bfdname"\c
 103 \&
 104 You can specify a particular object-code format \c
 105 .I bfdname\c
 106 \& for
 107 \c
 108 .I objfiles\c
 109 \&.  This may not be necessary; \c
 110 .I strip\c
 111 \& can automatically
 112 recognize many formats.   for information on listing
 113 available formats.
 114 .PP
 115
 116 .SH "SEE ALSO"
 117 .RB "`\|" binutils "\|'"
 118 entry in
 119 .B
 120 info\c
 121 \&;
 122 .I
 123 The GNU Binary Utilities\c
 124 \&, Roland H. Pesch (October 1991).
 125
 126 .SH COPYING
 127 Copyright (c) 1991 Free Software Foundation, Inc.
 128 .PP
 129 Permission is granted to make and distribute verbatim copies of
 130 this manual provided the copyright notice and this permission notice
 131 are preserved on all copies.
 132 .PP
 133 Permission is granted to copy and distribute modified versions of this
 134 manual under the conditions for verbatim copying, provided that the
 135 entire resulting derived work is distributed under the terms of a
 136 permission notice identical to this one.
 137 .PP
 138 Permission is granted to copy and distribute translations of this
 139 manual into another language, under the above conditions for modified
 140 versions, except that this permission notice may be included in
 141 translations approved by the Free Software Foundation instead of in
 142 the original English.