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