binutils/strip.1

   1 .\" Automatically generated by Pod::Man version 1.02
   2 .\" Wed May 30 12:24:29 2001
   3 .\"
   4 .\" Standard preamble:
   5 .\" ======================================================================
   6 .de Sh \" Subsection heading
   7 .br
   8 .if t .Sp
   9 .ne 5
  10 .PP
  11 \fB\\$1\fR
  12 .PP
  13 ..
  14 .de Sp \" Vertical space (when we can't use .PP)
  15 .if t .sp .5v
  16 .if n .sp
  17 ..
  18 .de Ip \" List item
  19 .br
  20 .ie \\n(.$>=3 .ne \\$3
  21 .el .ne 3
  22 .IP "\\$1" \\$2
  23 ..
  24 .de Vb \" Begin verbatim text
  25 .ft CW
  26 .nf
  27 .ne \\$1
  28 ..
  29 .de Ve \" End verbatim text
  30 .ft R
  31
  32 .fi
  33 ..
  34 .\" Set up some character translations and predefined strings.  \*(-- will
  35 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  36 .\" double quote, and \*(R" will give a right double quote.  | will give a
  37 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
  38 .\" to do unbreakable dashes and therefore won't be available.  \*(C` and
  39 .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
  40 .tr \(*W-|\(bv\*(Tr
  41 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  42 .ie n \{\
  43 .    ds -- \(*W-
  44 .    ds PI pi
  45 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  46 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  47 .    ds L" ""
  48 .    ds R" ""
  49 .    ds C` `
  50 .    ds C' '
  51 'br\}
  52 .el\{\
  53 .    ds -- \|\(em\|
  54 .    ds PI \(*p
  55 .    ds L" ``
  56 .    ds R" ''
  57 'br\}
  58 .\"
  59 .\" If the F register is turned on, we'll generate index entries on stderr
  60 .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
  61 .\" index entries marked with X<> in POD.  Of course, you'll have to process
  62 .\" the output yourself in some meaningful fashion.
  63 .if \nF \{\
  64 .    de IX
  65 .    tm Index:\\$1\t\\n%\t"\\$2"
  66 .    .
  67 .    nr % 0
  68 .    rr F
  69 .\}
  70 .\"
  71 .\" For nroff, turn off justification.  Always turn off hyphenation; it
  72 .\" makes way too many mistakes in technical documents.
  73 .hy 0
  74 .\"
  75 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  76 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  77 .bd B 3
  78 .    \" fudge factors for nroff and troff
  79 .if n \{\
  80 .    ds #H 0
  81 .    ds #V .8m
  82 .    ds #F .3m
  83 .    ds #[ \f1
  84 .    ds #] \fP
  85 .\}
  86 .if t \{\
  87 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  88 .    ds #V .6m
  89 .    ds #F 0
  90 .    ds #[ \&
  91 .    ds #] \&
  92 .\}
  93 .    \" simple accents for nroff and troff
  94 .if n \{\
  95 .    ds ' \&
  96 .    ds ` \&
  97 .    ds ^ \&
  98 .    ds , \&
  99 .    ds ~ ~
 100 .    ds /
 101 .\}
 102 .if t \{\
 103 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 104 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 105 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 106 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 107 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 108 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 109 .\}
 110 .    \" troff and (daisy-wheel) nroff accents
 111 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 112 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 113 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 114 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 115 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 116 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 117 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 118 .ds ae a\h'-(\w'a'u*4/10)'e
 119 .ds Ae A\h'-(\w'A'u*4/10)'E
 120 .    \" corrections for vroff
 121 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 122 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 123 .    \" for low resolution devices (crt and lpr)
 124 .if \n(.H>23 .if \n(.V>19 \
 125 \{\
 126 .    ds : e
 127 .    ds 8 ss
 128 .    ds o a
 129 .    ds d- d\h'-1'\(ga
 130 .    ds D- D\h'-1'\(hy
 131 .    ds th \o'bp'
 132 .    ds Th \o'LP'
 133 .    ds ae ae
 134 .    ds Ae AE
 135 .\}
 136 .rm #[ #] #H #V #F C
 137 .\" ======================================================================
 138 .\"
 139 .IX Title "STRIP.1 1"
 140 .TH STRIP.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
 141 .UC
 142 .SH "NAME"
 143 strip \- Discard symbols from object files.
 144 .SH "SYNOPSIS"
 145 .IX Header "SYNOPSIS"
 146 strip [ \-F \fIbfdname\fR | \-\-target=\fIbfdname\fR ]
 147       [ \-I \fIbfdname\fR | \-\-input-target=\fIbfdname\fR ]
 148       [ \-O \fIbfdname\fR | \-\-output-target=\fIbfdname\fR ]
 149       [ \-s | \-\-strip-all ] [ \-S | \-g | \-\-strip-debug ]
 150       [ \-K \fIsymbolname\fR | \-\-keep-symbol=\fIsymbolname\fR ]
 151       [ \-N \fIsymbolname\fR | \-\-strip-symbol=\fIsymbolname\fR ]
 152       [ \-x | \-\-discard-all ] [ \-X | \-\-discard-locals ]
 153       [ \-R \fIsectionname\fR | \-\-remove-section=\fIsectionname\fR ]
 154       [ \-o \fIfile\fR ] [ \-p | \-\-preserve-dates ]
 155       [ \-v | \-\-verbose ]  [ \-V | \-\-version ]  [ \-\-help ]
 156       \fIobjfile\fR...
 157 .SH "DESCRIPTION"
 158 .IX Header "DESCRIPTION"
 159 \&\s-1GNU\s0 \f(CW\*(C`strip\*(C'\fR discards all symbols from object files
 160 \&\fIobjfile\fR.  The list of object files may include archives.
 161 At least one object file must be given.
 162 .PP
 163 \&\f(CW\*(C`strip\*(C'\fR modifies the files named in its argument,
 164 rather than writing modified copies under different names.
 165 .SH "OPTIONS"
 166 .IX Header "OPTIONS"
 167 .Ip "\f(CW\*(C`\-F \f(CIbfdname\f(CW\*(C'\fR" 4
 168 .IX Item "-F bfdname"
 169 .Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
 170 .IX Item "--target=bfdname"
 171 Treat the original \fIobjfile\fR as a file with the object
 172 code format \fIbfdname\fR, and rewrite it in the same format.
 173 .Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
 174 .IX Item "--help"
 175 Show a summary of the options to \f(CW\*(C`strip\*(C'\fR and exit.
 176 .Ip "\f(CW\*(C`\-I \f(CIbfdname\f(CW    \*(C'\fR" 4
 177 .IX Item "-I bfdname    "
 178 .Ip "\f(CW\*(C`\-\-input\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
 179 .IX Item "--input-target=bfdname"
 180 Treat the original \fIobjfile\fR as a file with the object
 181 code format \fIbfdname\fR.
 182 .Ip "\f(CW\*(C`\-O \f(CIbfdname\f(CW\*(C'\fR" 4
 183 .IX Item "-O bfdname"
 184 .Ip "\f(CW\*(C`\-\-output\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
 185 .IX Item "--output-target=bfdname"
 186 Replace \fIobjfile\fR with a file in the output format \fIbfdname\fR.
 187 .Ip "\f(CW\*(C`\-R \f(CIsectionname\f(CW\*(C'\fR" 4
 188 .IX Item "-R sectionname"
 189 .Ip "\f(CW\*(C`\-\-remove\-section=\f(CIsectionname\f(CW\*(C'\fR" 4
 190 .IX Item "--remove-section=sectionname"
 191 Remove any section named \fIsectionname\fR from the output file.  This
 192 option may be given more than once.  Note that using this option
 193 inappropriately may make the output file unusable.
 194 .Ip "\f(CW\*(C`\-s\*(C'\fR" 4
 195 .IX Item "-s"
 196 .Ip "\f(CW\*(C`\-\-strip\-all\*(C'\fR" 4
 197 .IX Item "--strip-all"
 198 Remove all symbols.
 199 .Ip "\f(CW\*(C`\-g\*(C'\fR" 4
 200 .IX Item "-g"
 201 .Ip "\f(CW\*(C`\-S\*(C'\fR" 4
 202 .IX Item "-S"
 203 .Ip "\f(CW\*(C`\-\-strip\-debug\*(C'\fR" 4
 204 .IX Item "--strip-debug"
 205 Remove debugging symbols only.
 206 .Ip "\f(CW\*(C`\-\-strip\-unneeded\*(C'\fR" 4
 207 .IX Item "--strip-unneeded"
 208 Remove all symbols that are not needed for relocation processing.
 209 .Ip "\f(CW\*(C`\-K \f(CIsymbolname\f(CW\*(C'\fR" 4
 210 .IX Item "-K symbolname"
 211 .Ip "\f(CW\*(C`\-\-keep\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
 212 .IX Item "--keep-symbol=symbolname"
 213 Keep only symbol \fIsymbolname\fR from the source file.  This option may
 214 be given more than once.
 215 .Ip "\f(CW\*(C`\-N \f(CIsymbolname\f(CW\*(C'\fR" 4
 216 .IX Item "-N symbolname"
 217 .Ip "\f(CW\*(C`\-\-strip\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
 218 .IX Item "--strip-symbol=symbolname"
 219 Remove symbol \fIsymbolname\fR from the source file. This option may be
 220 given more than once, and may be combined with strip options other than
 221 \&\f(CW\*(C`\-K\*(C'\fR.
 222 .Ip "\f(CW\*(C`\-o \f(CIfile\f(CW\*(C'\fR" 4
 223 .IX Item "-o file"
 224 Put the stripped output in \fIfile\fR, rather than replacing the
 225 existing file.  When this argument is used, only one \fIobjfile\fR
 226 argument may be specified.
 227 .Ip "\f(CW\*(C`\-p\*(C'\fR" 4
 228 .IX Item "-p"
 229 .Ip "\f(CW\*(C`\-\-preserve\-dates\*(C'\fR" 4
 230 .IX Item "--preserve-dates"
 231 Preserve the access and modification dates of the file.
 232 .Ip "\f(CW\*(C`\-x\*(C'\fR" 4
 233 .IX Item "-x"
 234 .Ip "\f(CW\*(C`\-\-discard\-all\*(C'\fR" 4
 235 .IX Item "--discard-all"
 236 Remove non-global symbols.
 237 .Ip "\f(CW\*(C`\-X\*(C'\fR" 4
 238 .IX Item "-X"
 239 .Ip "\f(CW\*(C`\-\-discard\-locals\*(C'\fR" 4
 240 .IX Item "--discard-locals"
 241 Remove compiler-generated local symbols.
 242 (These usually start with \fBL\fR or \fB.\fR.)
 243 .Ip "\f(CW\*(C`\-V\*(C'\fR" 4
 244 .IX Item "-V"
 245 .Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
 246 .IX Item "--version"
 247 Show the version number for \f(CW\*(C`strip\*(C'\fR.
 248 .Ip "\f(CW\*(C`\-v\*(C'\fR" 4
 249 .IX Item "-v"
 250 .Ip "\f(CW\*(C`\-\-verbose\*(C'\fR" 4
 251 .IX Item "--verbose"
 252 Verbose output: list all object files modified.  In the case of
 253 archives, \fBstrip \-v\fR lists all members of the archive.
 254 .SH "SEE ALSO"
 255 .IX Header "SEE ALSO"
 256 the Info entries for \fIbinutils\fR.
 257 .SH "COPYRIGHT"
 258 .IX Header "COPYRIGHT"
 259 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 260 .PP
 261 Permission is granted to copy, distribute and/or modify this document
 262 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 263 or any later version published by the Free Software Foundation;
 264 with no Invariant Sections, with no Front-Cover Texts, and with no
 265 Back-Cover Texts.  A copy of the license is included in the
 266 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".