contrib/binutils-2.14/binutils/doc/strip.1

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