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