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