[deliverable/binutils-gdb.git] / binutils / strip.1

.rn '' }`
''' $RCSfile$$Revision$$Date$
'''
''' $Log$
''' Revision 1.6  2001/03/25 20:32:25  nickc
''' Automate generate on man pages
'''
'''
.de Sh
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp
.if t .sp .5v
.if n .sp
..
.de Ip
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R

.fi
..
'''
'''
'''     Set up \*(-- to give an unbreakable dash;
'''     string Tr holds user defined translation string.
'''     Bell System Logo is used as a dummy character.
'''
.tr \(*W-|\(bv\*(Tr
.ie n \{\
.ds -- \(*W-
.ds PI pi
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.ds L" ""
.ds R" ""
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
'''   such as .IP and .SH, which do another additional levels of
'''   double-quote interpretation
.ds M" """
.ds S" """
.ds N" """""
.ds T" """""
.ds L' '
.ds R' '
.ds M' '
.ds S' '
.ds N' '
.ds T' '
'br\}
.el\{\
.ds -- \(em\|
.tr \*(Tr
.ds L" ``
.ds R" ''
.ds M" ``
.ds S" ''
.ds N" ``
.ds T" ''
.ds L' `
.ds R' '
.ds M' `
.ds S' '
.ds N' `
.ds T' '
.ds PI \(*p
'br\}
.\"	If the F register is turned on, we'll generate
.\"	index entries out stderr for the following things:
.\"		TH	Title 
.\"		SH	Header
.\"		Sh	Subsection 
.\"		Ip	Item
.\"		X<>	Xref  (embedded
.\"	Of course, you have to process the output yourself
.\"	in some meaninful fashion.
.if \nF \{
.de IX
.tm Index:\\$1\t\\n%\t"\\$2"
..
.nr % 0
.rr F
.\}
.TH STRIP.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
.UC
.if n .hy 0
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.de CQ          \" put $1 in typewriter font
.ft CW
'if n "\c
'if t \\&\\$1\c
'if n \\&\\$1\c
'if n \&"
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
'.ft R
..
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.bd B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.	ds #V .6m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' \&
.	ds ` \&
.	ds ^ \&
.	ds , \&
.	ds ~ ~
.	ds ? ?
.	ds ! !
.	ds /
.	ds q
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	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'
.\}
.	\" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : e
.	ds 8 ss
.	ds v \h'-1'\o'\(aa\(ga'
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C
.SH "NAME"
strip \- Discard symbols from object files.
.SH "SYNOPSIS"
strip [ \-F \fIbfdname\fR | --target=\fIbfdname\fR ]
      [ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
      [ \-O \fIbfdname\fR | --output-target=\fIbfdname\fR ]
      [ \-s | --strip-all ] [ \-S | \-g | --strip-debug ]
      [ \-K \fIsymbolname\fR | --keep-symbol=\fIsymbolname\fR ]
      [ \-N \fIsymbolname\fR | --strip-symbol=\fIsymbolname\fR ]
      [ \-x | --discard-all ] [ \-X | --discard-locals ]
      [ \-R \fIsectionname\fR | --remove-section=\fIsectionname\fR ]
      [ \-o \fIfile\fR ] [ \-p | --preserve-dates ]
      [ \-v | --verbose ]  [ \-V | --version ]  [ --help ]
      \fIobjfile\fR...
.SH "DESCRIPTION"
GNU \f(CWstrip\fR discards all symbols from object files
\fIobjfile\fR.  The list of object files may include archives.
At least one object file must be given.
.PP
\f(CWstrip\fR modifies the files named in its argument,
rather than writing modified copies under different names.
.SH "OPTIONS"
.Ip "\f(CW-F \fIbfdname\fR\fR" 4
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
Treat the original \fIobjfile\fR as a file with the object
code format \fIbfdname\fR, and rewrite it in the same format.
.Ip "\f(CW--help\fR" 4
Show a summary of the options to \f(CWstrip\fR and exit.
.Ip "\f(CW-I \fIbfdname\fR	\fR" 4
.Ip "\f(CW--input-target=\fIbfdname\fR\fR" 4
Treat the original \fIobjfile\fR as a file with the object
code format \fIbfdname\fR.
.Ip "\f(CW-O \fIbfdname\fR\fR" 4
.Ip "\f(CW--output-target=\fIbfdname\fR\fR" 4
Replace \fIobjfile\fR with a file in the output format \fIbfdname\fR.
.Ip "\f(CW-R \fIsectionname\fR\fR" 4
.Ip "\f(CW--remove-section=\fIsectionname\fR\fR" 4
Remove any section named \fIsectionname\fR from the output file.  This
option may be given more than once.  Note that using this option
inappropriately may make the output file unusable.
.Ip "\f(CW-s\fR" 4
.Ip "\f(CW--strip-all\fR" 4
Remove all symbols.
.Ip "\f(CW-g\fR" 4
.Ip "\f(CW-S\fR" 4
.Ip "\f(CW--strip-debug\fR" 4
Remove debugging symbols only.
.Ip "\f(CW--strip-unneeded\fR" 4
Remove all symbols that are not needed for relocation processing.
.Ip "\f(CW-K \fIsymbolname\fR\fR" 4
.Ip "\f(CW--keep-symbol=\fIsymbolname\fR\fR" 4
Keep only symbol \fIsymbolname\fR from the source file.  This option may
be given more than once.
.Ip "\f(CW-N \fIsymbolname\fR\fR" 4
.Ip "\f(CW--strip-symbol=\fIsymbolname\fR\fR" 4
Remove symbol \fIsymbolname\fR from the source file. This option may be
given more than once, and may be combined with strip options other than
\f(CW-K\fR.
.Ip "\f(CW-o \fIfile\fR\fR" 4
Put the stripped output in \fIfile\fR, rather than replacing the
existing file.  When this argument is used, only one \fIobjfile\fR
argument may be specified.
.Ip "\f(CW-p\fR" 4
.Ip "\f(CW--preserve-dates\fR" 4
Preserve the access and modification dates of the file.
.Ip "\f(CW-x\fR" 4
.Ip "\f(CW--discard-all\fR" 4
Remove non-global symbols.
.Ip "\f(CW-X\fR" 4
.Ip "\f(CW--discard-locals\fR" 4
Remove compiler-generated local symbols.
(These usually start with \fBL\fR or \fB.\fR.)
.Ip "\f(CW-V\fR" 4
.Ip "\f(CW--version\fR" 4
Show the version number for \f(CWstrip\fR.
.Ip "\f(CW-v\fR" 4
.Ip "\f(CW--verbose\fR" 4
Verbose output: list all object files modified.  In the case of
archives, \fBstrip \-v\fR lists all members of the archive.
.SH "SEE ALSO"
the Info entries for \fIbinutils\fR.
.SH "COPYRIGHT"
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts.  A copy of the license is included in the
section entitled \*(L"GNU Free Documentation License\*(R".

.rn }` ''
.IX Title "STRIP.1 1"
.IX Name "strip - Discard symbols from object files."

.IX Header "NAME"

.IX Header "SYNOPSIS"

.IX Header "DESCRIPTION"

.IX Header "OPTIONS"

.IX Item "\f(CW-F \fIbfdname\fR\fR"

.IX Item "\f(CW--target=\fIbfdname\fR\fR"

.IX Item "\f(CW--help\fR"

.IX Item "\f(CW-I \fIbfdname\fR	\fR"

.IX Item "\f(CW--input-target=\fIbfdname\fR\fR"

.IX Item "\f(CW-O \fIbfdname\fR\fR"

.IX Item "\f(CW--output-target=\fIbfdname\fR\fR"

.IX Item "\f(CW-R \fIsectionname\fR\fR"

.IX Item "\f(CW--remove-section=\fIsectionname\fR\fR"

.IX Item "\f(CW-s\fR"

.IX Item "\f(CW--strip-all\fR"

.IX Item "\f(CW-g\fR"

.IX Item "\f(CW-S\fR"

.IX Item "\f(CW--strip-debug\fR"

.IX Item "\f(CW--strip-unneeded\fR"

.IX Item "\f(CW-K \fIsymbolname\fR\fR"

.IX Item "\f(CW--keep-symbol=\fIsymbolname\fR\fR"

.IX Item "\f(CW-N \fIsymbolname\fR\fR"

.IX Item "\f(CW--strip-symbol=\fIsymbolname\fR\fR"

.IX Item "\f(CW-o \fIfile\fR\fR"

.IX Item "\f(CW-p\fR"

.IX Item "\f(CW--preserve-dates\fR"

.IX Item "\f(CW-x\fR"

.IX Item "\f(CW--discard-all\fR"

.IX Item "\f(CW-X\fR"

.IX Item "\f(CW--discard-locals\fR"

.IX Item "\f(CW-V\fR"

.IX Item "\f(CW--version\fR"

.IX Item "\f(CW-v\fR"

.IX Item "\f(CW--verbose\fR"

.IX Header "SEE ALSO"

.IX Header "COPYRIGHT"
Commit	Line	Data
0285c67d NC	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
252b5132	26	..
0285c67d NC	27	.de Vb
	28	.ft CW
	29	.nf
	30	.ne \\$1
	31	..
	32	.de Ve
	33	.ft R
252b5132	34
0285c67d NC	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(.wu8/10-\(#H)'\'\h"\|\\n:u"
144	. ds ` \\k:\h'-(\\n(.wu8/10-\(#H)'\`\h'\|\\n:u'
145	. ds ^ \\k:\h'-(\\n(.wu10/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'u7/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(.wu8/10-\(#H)'\z\(sl\h'\|\\n:u'
151	. ds q o\h'-\w'o'u8/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(.wu8/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(.wu9/10-\(#H)'\v'-\(#V'\(#[\s-4v\s0\v'\(#V'\h'\|\\n:u'\(#]
157	.ds _ \\k:\h'-(\\n(.wu9/10-\(#H+(\(#F2/3))'\v'-.4m'\z\(hy\v'.4m'\h'\|\\n:u'
158	.ds . \\k:\h'-(\\n(.wu8/10)'\v'\(#V4/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'u2/3)'\s-1o\s+1\*(#]
164	.ds Th \(#[\s+2I\s-2\h'-\w'I'u3/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(.wu9/10-\(#H)'\s-2\u~\d\s+2\h'\|\\n:u'
171	.if v .ds ^ \\k:\h'-(\\n(.wu10/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"
252b5132	193	strip \- Discard symbols from object files.
0285c67d NC	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.
252b5132	209	At least one object file must be given.
0285c67d NC	210	.PP
0285c67d NC	211	\f(CWstrip\fR modifies the files named in its argument,
252b5132	212	rather than writing modified copies under different names.
0285c67d NC	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
252b5132	234	Remove all symbols.
0285c67d NC	235	.Ip "\f(CW-g\fR" 4
	236	.Ip "\f(CW-S\fR" 4
	237	.Ip "\f(CW--strip-debug\fR" 4
252b5132	238	Remove debugging symbols only.
0285c67d NC	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
252b5132 RH	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.
0285c67d NC	254	.Ip "\f(CW-p\fR" 4
0285c67d NC	255	.Ip "\f(CW--preserve-dates\fR" 4
252b5132	256	Preserve the access and modification dates of the file.
0285c67d NC	257	.Ip "\f(CW-x\fR" 4
0285c67d NC	258	.Ip "\f(CW--discard-all\fR" 4
252b5132	259	Remove non-global symbols.
0285c67d NC	260	.Ip "\f(CW-X\fR" 4
0285c67d NC	261	.Ip "\f(CW--discard-locals\fR" 4
252b5132	262	Remove compiler-generated local symbols.
0285c67d NC	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
252b5132	269	Verbose output: list all object files modified. In the case of
0285c67d	270	archives, \fBstrip \-v\fR lists all members of the archive.
252b5132	271	.SH "SEE ALSO"
0285c67d NC	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.
cf055d54	275	.PP
0285c67d NC	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