binutils/strip.1

   1 .rn '' }`
   2 ''' $RCSfile$$Revision$$Date$
   3 '''
   4 ''' $Log$
   5 ''' Revision 1.6  2001/03/25 20:32:25  nickc
   6 ''' Automate generate on man pages
   7 '''
   8 '''
   9 .de Sh
  10 .br
  11 .if t .Sp
  12 .ne 5
  13 .PP
  14 \fB\\$1\fR
  15 .PP
  16 ..
  17 .de Sp
  18 .if t .sp .5v
  19 .if n .sp
  20 ..
  21 .de Ip
  22 .br
  23 .ie \\n(.$>=3 .ne \\$3
  24 .el .ne 3
  25 .IP "\\$1" \\$2
  26 ..
  27 .de Vb
  28 .ft CW
  29 .nf
  30 .ne \\$1
  31 ..
  32 .de Ve
  33 .ft R
  34
  35 .fi
  36 ..
  37 '''
  38 '''
  39 '''     Set up \*(-- to give an unbreakable dash;
  40 '''     string Tr holds user defined translation string.
  41 '''     Bell System Logo is used as a dummy character.
  42 '''
  43 .tr \(*W-|\(bv\*(Tr
  44 .ie n \{\
  45 .ds -- \(*W-
  46 .ds PI pi
  47 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  48 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
  49 .ds L" ""
  50 .ds R" ""
  51 '''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
  52 '''   \*(L" and \*(R", except that they are used on ".xx" lines,
  53 '''   such as .IP and .SH, which do another additional levels of
  54 '''   double-quote interpretation
  55 .ds M" """
  56 .ds S" """
  57 .ds N" """""
  58 .ds T" """""
  59 .ds L' '
  60 .ds R' '
  61 .ds M' '
  62 .ds S' '
  63 .ds N' '
  64 .ds T' '
  65 'br\}
  66 .el\{\
  67 .ds -- \(em\|
  68 .tr \*(Tr
  69 .ds L" ``
  70 .ds R" ''
  71 .ds M" ``
  72 .ds S" ''
  73 .ds N" ``
  74 .ds T" ''
  75 .ds L' `
  76 .ds R' '
  77 .ds M' `
  78 .ds S' '
  79 .ds N' `
  80 .ds T' '
  81 .ds PI \(*p
  82 'br\}
  83 .\"     If the F register is turned on, we'll generate
  84 .\"     index entries out stderr for the following things:
  85 .\"             TH      Title
  86 .\"             SH      Header
  87 .\"             Sh      Subsection
  88 .\"             Ip      Item
  89 .\"             X<>     Xref  (embedded
  90 .\"     Of course, you have to process the output yourself
  91 .\"     in some meaninful fashion.
  92 .if \nF \{
  93 .de IX
  94 .tm Index:\\$1\t\\n%\t"\\$2"
  95 ..
  96 .nr % 0
  97 .rr F
  98 .\}
  99 .TH STRIP.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
 100 .UC
 101 .if n .hy 0
 102 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 103 .de CQ          \" put $1 in typewriter font
 104 .ft CW
 105 'if n "\c
 106 'if t \\&\\$1\c
 107 'if n \\&\\$1\c
 108 'if n \&"
 109 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
 110 '.ft R
 111 ..
 112 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
 113 .       \" AM - accent mark definitions
 114 .bd B 3
 115 .       \" fudge factors for nroff and troff
 116 .if n \{\
 117 .       ds #H 0
 118 .       ds #V .8m
 119 .       ds #F .3m
 120 .       ds #[ \f1
 121 .       ds #] \fP
 122 .\}
 123 .if t \{\
 124 .       ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 125 .       ds #V .6m
 126 .       ds #F 0
 127 .       ds #[ \&
 128 .       ds #] \&
 129 .\}
 130 .       \" simple accents for nroff and troff
 131 .if n \{\
 132 .       ds ' \&
 133 .       ds ` \&
 134 .       ds ^ \&
 135 .       ds , \&
 136 .       ds ~ ~
 137 .       ds ? ?
 138 .       ds ! !
 139 .       ds /
 140 .       ds q
 141 .\}
 142 .if t \{\
 143 .       ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 144 .       ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 145 .       ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 146 .       ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 147 .       ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 148 .       ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
 149 .       ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
 150 .       ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 151 .       ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
 152 .\}
 153 .       \" troff and (daisy-wheel) nroff accents
 154 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 155 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 156 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
 157 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
 158 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
 159 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
 160 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 161 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 162 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 163 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 164 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 165 .ds ae a\h'-(\w'a'u*4/10)'e
 166 .ds Ae A\h'-(\w'A'u*4/10)'E
 167 .ds oe o\h'-(\w'o'u*4/10)'e
 168 .ds Oe O\h'-(\w'O'u*4/10)'E
 169 .       \" corrections for vroff
 170 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 171 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 172 .       \" for low resolution devices (crt and lpr)
 173 .if \n(.H>23 .if \n(.V>19 \
 174 \{\
 175 .       ds : e
 176 .       ds 8 ss
 177 .       ds v \h'-1'\o'\(aa\(ga'
 178 .       ds _ \h'-1'^
 179 .       ds . \h'-1'.
 180 .       ds 3 3
 181 .       ds o a
 182 .       ds d- d\h'-1'\(ga
 183 .       ds D- D\h'-1'\(hy
 184 .       ds th \o'bp'
 185 .       ds Th \o'LP'
 186 .       ds ae ae
 187 .       ds Ae AE
 188 .       ds oe oe
 189 .       ds Oe OE
 190 .\}
 191 .rm #[ #] #H #V #F C
 192 .SH "NAME"
 193 strip \- Discard symbols from object files.
 194 .SH "SYNOPSIS"
 195 strip [ \-F \fIbfdname\fR | --target=\fIbfdname\fR ]
 196       [ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
 197       [ \-O \fIbfdname\fR | --output-target=\fIbfdname\fR ]
 198       [ \-s | --strip-all ] [ \-S | \-g | --strip-debug ]
 199       [ \-K \fIsymbolname\fR | --keep-symbol=\fIsymbolname\fR ]
 200       [ \-N \fIsymbolname\fR | --strip-symbol=\fIsymbolname\fR ]
 201       [ \-x | --discard-all ] [ \-X | --discard-locals ]
 202       [ \-R \fIsectionname\fR | --remove-section=\fIsectionname\fR ]
 203       [ \-o \fIfile\fR ] [ \-p | --preserve-dates ]
 204       [ \-v | --verbose ]  [ \-V | --version ]  [ --help ]
 205       \fIobjfile\fR...
 206 .SH "DESCRIPTION"
 207 GNU \f(CWstrip\fR discards all symbols from object files
 208 \fIobjfile\fR.  The list of object files may include archives.
 209 At least one object file must be given.
 210 .PP
 211 \f(CWstrip\fR modifies the files named in its argument,
 212 rather than writing modified copies under different names.
 213 .SH "OPTIONS"
 214 .Ip "\f(CW-F \fIbfdname\fR\fR" 4
 215 .Ip "\f(CW--target=\fIbfdname\fR\fR" 4
 216 Treat the original \fIobjfile\fR as a file with the object
 217 code format \fIbfdname\fR, and rewrite it in the same format.
 218 .Ip "\f(CW--help\fR" 4
 219 Show a summary of the options to \f(CWstrip\fR and exit.
 220 .Ip "\f(CW-I \fIbfdname\fR      \fR" 4
 221 .Ip "\f(CW--input-target=\fIbfdname\fR\fR" 4
 222 Treat the original \fIobjfile\fR as a file with the object
 223 code format \fIbfdname\fR.
 224 .Ip "\f(CW-O \fIbfdname\fR\fR" 4
 225 .Ip "\f(CW--output-target=\fIbfdname\fR\fR" 4
 226 Replace \fIobjfile\fR with a file in the output format \fIbfdname\fR.
 227 .Ip "\f(CW-R \fIsectionname\fR\fR" 4
 228 .Ip "\f(CW--remove-section=\fIsectionname\fR\fR" 4
 229 Remove any section named \fIsectionname\fR from the output file.  This
 230 option may be given more than once.  Note that using this option
 231 inappropriately may make the output file unusable.
 232 .Ip "\f(CW-s\fR" 4
 233 .Ip "\f(CW--strip-all\fR" 4
 234 Remove all symbols.
 235 .Ip "\f(CW-g\fR" 4
 236 .Ip "\f(CW-S\fR" 4
 237 .Ip "\f(CW--strip-debug\fR" 4
 238 Remove debugging symbols only.
 239 .Ip "\f(CW--strip-unneeded\fR" 4
 240 Remove all symbols that are not needed for relocation processing.
 241 .Ip "\f(CW-K \fIsymbolname\fR\fR" 4
 242 .Ip "\f(CW--keep-symbol=\fIsymbolname\fR\fR" 4
 243 Keep only symbol \fIsymbolname\fR from the source file.  This option may
 244 be given more than once.
 245 .Ip "\f(CW-N \fIsymbolname\fR\fR" 4
 246 .Ip "\f(CW--strip-symbol=\fIsymbolname\fR\fR" 4
 247 Remove symbol \fIsymbolname\fR from the source file. This option may be
 248 given more than once, and may be combined with strip options other than
 249 \f(CW-K\fR.
 250 .Ip "\f(CW-o \fIfile\fR\fR" 4
 251 Put the stripped output in \fIfile\fR, rather than replacing the
 252 existing file.  When this argument is used, only one \fIobjfile\fR
 253 argument may be specified.
 254 .Ip "\f(CW-p\fR" 4
 255 .Ip "\f(CW--preserve-dates\fR" 4
 256 Preserve the access and modification dates of the file.
 257 .Ip "\f(CW-x\fR" 4
 258 .Ip "\f(CW--discard-all\fR" 4
 259 Remove non-global symbols.
 260 .Ip "\f(CW-X\fR" 4
 261 .Ip "\f(CW--discard-locals\fR" 4
 262 Remove compiler-generated local symbols.
 263 (These usually start with \fBL\fR or \fB.\fR.)
 264 .Ip "\f(CW-V\fR" 4
 265 .Ip "\f(CW--version\fR" 4
 266 Show the version number for \f(CWstrip\fR.
 267 .Ip "\f(CW-v\fR" 4
 268 .Ip "\f(CW--verbose\fR" 4
 269 Verbose output: list all object files modified.  In the case of
 270 archives, \fBstrip \-v\fR lists all members of the archive.
 271 .SH "SEE ALSO"
 272 the Info entries for \fIbinutils\fR.
 273 .SH "COPYRIGHT"
 274 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 275 .PP
 276 Permission is granted to copy, distribute and/or modify this document
 277 under the terms of the GNU Free Documentation License, Version 1.1
 278 or any later version published by the Free Software Foundation;
 279 with no Invariant Sections, with no Front-Cover Texts, and with no
 280 Back-Cover Texts.  A copy of the license is included in the
 281 section entitled \*(L"GNU Free Documentation License\*(R".
 282
 283 .rn }` ''
 284 .IX Title "STRIP.1 1"
 285 .IX Name "strip - Discard symbols from object files."
 286
 287 .IX Header "NAME"
 288
 289 .IX Header "SYNOPSIS"
 290
 291 .IX Header "DESCRIPTION"
 292
 293 .IX Header "OPTIONS"
 294
 295 .IX Item "\f(CW-F \fIbfdname\fR\fR"
 296
 297 .IX Item "\f(CW--target=\fIbfdname\fR\fR"
 298
 299 .IX Item "\f(CW--help\fR"
 300
 301 .IX Item "\f(CW-I \fIbfdname\fR \fR"
 302
 303 .IX Item "\f(CW--input-target=\fIbfdname\fR\fR"
 304
 305 .IX Item "\f(CW-O \fIbfdname\fR\fR"
 306
 307 .IX Item "\f(CW--output-target=\fIbfdname\fR\fR"
 308
 309 .IX Item "\f(CW-R \fIsectionname\fR\fR"
 310
 311 .IX Item "\f(CW--remove-section=\fIsectionname\fR\fR"
 312
 313 .IX Item "\f(CW-s\fR"
 314
 315 .IX Item "\f(CW--strip-all\fR"
 316
 317 .IX Item "\f(CW-g\fR"
 318
 319 .IX Item "\f(CW-S\fR"
 320
 321 .IX Item "\f(CW--strip-debug\fR"
 322
 323 .IX Item "\f(CW--strip-unneeded\fR"
 324
 325 .IX Item "\f(CW-K \fIsymbolname\fR\fR"
 326
 327 .IX Item "\f(CW--keep-symbol=\fIsymbolname\fR\fR"
 328
 329 .IX Item "\f(CW-N \fIsymbolname\fR\fR"
 330
 331 .IX Item "\f(CW--strip-symbol=\fIsymbolname\fR\fR"
 332
 333 .IX Item "\f(CW-o \fIfile\fR\fR"
 334
 335 .IX Item "\f(CW-p\fR"
 336
 337 .IX Item "\f(CW--preserve-dates\fR"
 338
 339 .IX Item "\f(CW-x\fR"
 340
 341 .IX Item "\f(CW--discard-all\fR"
 342
 343 .IX Item "\f(CW-X\fR"
 344
 345 .IX Item "\f(CW--discard-locals\fR"
 346
 347 .IX Item "\f(CW-V\fR"
 348
 349 .IX Item "\f(CW--version\fR"
 350
 351 .IX Item "\f(CW-v\fR"
 352
 353 .IX Item "\f(CW--verbose\fR"
 354
 355 .IX Header "SEE ALSO"
 356
 357 .IX Header "COPYRIGHT"
 358