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

.\" Copyright (c) 1991 Free Software Foundation
.\" See section COPYING for conditions for redistribution
.TH strip 1 "5 November 1991" "cygnus support" "GNU Development Tools"
.de BP
.sp
.ti \-.2i
\(**
..

.SH NAME
strip \- Discard symbols from object files.

.SH SYNOPSIS
.hy 0
.na
.TP
.B strip
.RB "[\|" \-F\ \fIbfdname\fR\ |\ \fB\-\-target=\fIbfdname\fP "\|]"
.RB "[\|" \-I\ \fIbfdname\fR\ |\ \fB\-\-input\-target=\fIbfdname\fP "\|]"
.RB "[\|" \-O\ \fIbfdname\fR\ |\ \fB\-\-output\-target=\fIbfdname\fP "\|]"
.RB "[\|" \-R\ \fIsectionname\fR\ |\ \fB\-\-remove\-section=\fIsectionname\fP "\|]"
.RB "[\|" \-s\fR\ |\ \fB\-\-strip\-all "\|]"
.RB "[\|" \-S\fR\ |\ \fB\-g\fR\ |\ \fB\-\-strip\-debug "\|]"
.RB "[\|" \-\-strip\-unneeded\fR "\|]"
.RB "[\|" \-x\fR\ |\ \fB\-\-discard\-all "\|]"
.RB "[\|" \-X\fR\ |\ \fB\-\-discard\-locals "\|]"
.RB "[\|" \-K\ \fIsymbolname\fR\ |\ \fB\-\-keep\-symbol=\fIsymbolname\fR "\|]" 
.RB "[\|" \-N\ \fIsymbolname\fR\ |\ \fB\-\-strip\-symbol=\fIsymbolname\fR "\|]"
.RB "[\|" \-o\ \fIfile\f\R "\|]"
.RB "[\|" \-v\fR\ |\ \fB\-\-verbose "\|]"
.RB "[\|" \-V\fR\ |\ \fB\-\-version "\|]"
.RB "[\|" \-V\fR\ |\ \fB\-\-help "\|]"
.I objfile\c
\&.\|.\|.

.SH DESCRIPTION
GNU
.B strip
discards all symbols from the object files
.IR objfile .
The list of object files may include archives.
At least one object file must be given.

.P
.B strip
modifies the files named in its argument,
rather than writing modified copies under different names.

.SH OPTIONS
.TP
.B "\-F \fIbfdname"
.TP
.B "\-\-target=\fIbfdname"
Treat the original \fIobjfile\fP as a file with the object
code format \fIbfdname\fP, and rewrite it in the same format.

.TP
.B \-\-help
Show a summary of the options to
.B strip
and exit.

.TP
.B "\-I \fIbfdname
.TP
.B "\-\-input\-target=\fIbfdname"
Treat the original \fIobjfile\fP as a file with the object
code format \fIbfdname\fP.

.TP
.B "\-O \fIbfdname\fP"
.TP
.B "\-\-output\-target=\fIbfdname"
Replace \fIobjfile\fP with a file in the output format \fIbfdname\fP.

.TP
.B "\-R \fIsectionname\fP"
.TP
.B "\-\-remove\-section=\fIsectionname"
Remove the named section from the file.  This option may be given more
than once.  Note that using this option inappropriately may make the
object file unusable.

.TP
.B \-s
.TP
.B \-\-strip\-all
Remove all symbols.

.TP
.B \-S
.TP
.B \-g
.TP
.B \-\-strip\-debug
Remove debugging symbols only.

.TP
.B \-\-strip\-unneeded
Strip all symbols that are not needed for relocation processing.

.TP
.B \-N \fIsymbolname\fR
.TP
.B \-\-strip\-symbol=\fIsymbolname
Remove symbol \fIsymbolname\fP from the source file. This option
may be given more than once, and may be combined with other strip
options.

.TP
.B \-o \fIfile\fR
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.

.TP
.B \-x
.TP
.B \-\-discard\-all
Remove non-global symbols.

.TP
.B \-X
.TP
.B \-\-discard\-locals
Remove compiler-generated local symbols.
(These usually start with ``L'' or ``.''.)

.TP
.B \-K \fIsymbolname\fR, \fB\-\-keep\-symbol=\fIsymbolname
Copy only symbol \fIsymbolname\fP from the source file. This option
may be given more than once.

.TP
.B \-N \fIsymbolname\fR, \fB\-\-strip\-symbol=\fIsymbolname
Do not copy symbol \fIsymbolname\fP from the source file. This option
may be given more than once, and may be combined with strip options
other than \fB\-K\fR.

.TP
.B \-v
.TP
.B \-\-verbose
Verbose output: list all object files modified.  In the case of
archives,
.B "strip \-V"
lists all members of the archive.

.TP
.B \-V
.TP
.B \-\-version
Show the version number for \fBstrip\fP and exit.

.SH "SEE ALSO"
.RB "`\|" binutils "\|'" 
entry in 
.BR info ;
.IR "The GNU Binary Utilities" ,
Roland H. Pesch (October 1991).

.SH COPYING
Copyright (c) 1991 Free Software Foundation, Inc.
.PP
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
.PP
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
.PP
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in
the original English.
Commit	Line	Data
	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 \- Discard symbols from object files.
	12
	13	.SH SYNOPSIS
	14	.hy 0
	15	.na
	16	.TP
	17	.B strip
	18	.RB "[\\|" \-F\ \fIbfdname\fR\ \|\ \fB\-\-target=\fIbfdname\fP "\\|]"
	19	.RB "[\\|" \-I\ \fIbfdname\fR\ \|\ \fB\-\-input\-target=\fIbfdname\fP "\\|]"
	20	.RB "[\\|" \-O\ \fIbfdname\fR\ \|\ \fB\-\-output\-target=\fIbfdname\fP "\\|]"
	21	.RB "[\\|" \-R\ \fIsectionname\fR\ \|\ \fB\-\-remove\-section=\fIsectionname\fP "\\|]"
	22	.RB "[\\|" \-s\fR\ \|\ \fB\-\-strip\-all "\\|]"
	23	.RB "[\\|" \-S\fR\ \|\ \fB\-g\fR\ \|\ \fB\-\-strip\-debug "\\|]"
	24	.RB "[\\|" \-\-strip\-unneeded\fR "\\|]"
	25	.RB "[\\|" \-x\fR\ \|\ \fB\-\-discard\-all "\\|]"
	26	.RB "[\\|" \-X\fR\ \|\ \fB\-\-discard\-locals "\\|]"
	27	.RB "[\\|" \-K\ \fIsymbolname\fR\ \|\ \fB\-\-keep\-symbol=\fIsymbolname\fR "\\|]"
	28	.RB "[\\|" \-N\ \fIsymbolname\fR\ \|\ \fB\-\-strip\-symbol=\fIsymbolname\fR "\\|]"
	29	.RB "[\\|" \-o\ \fIfile\f\R "\\|]"
	30	.RB "[\\|" \-v\fR\ \|\ \fB\-\-verbose "\\|]"
	31	.RB "[\\|" \-V\fR\ \|\ \fB\-\-version "\\|]"
	32	.RB "[\\|" \-V\fR\ \|\ \fB\-\-help "\\|]"
	33	.I objfile\c
	34	\&.\\|.\\|.
	35
	36	.SH DESCRIPTION
	37	GNU
	38	.B strip
	39	discards all symbols from the object files
	40	.IR objfile .
	41	The list of object files may include archives.
	42	At least one object file must be given.
	43
	44	.P
	45	.B strip
	46	modifies the files named in its argument,
	47	rather than writing modified copies under different names.
	48
	49	.SH OPTIONS
	50	.TP
	51	.B "\-F \fIbfdname"
	52	.TP
	53	.B "\-\-target=\fIbfdname"
	54	Treat the original \fIobjfile\fP as a file with the object
	55	code format \fIbfdname\fP, and rewrite it in the same format.
	56
	57	.TP
	58	.B \-\-help
	59	Show a summary of the options to
	60	.B strip
	61	and exit.
	62
	63	.TP
	64	.B "\-I \fIbfdname
	65	.TP
	66	.B "\-\-input\-target=\fIbfdname"
	67	Treat the original \fIobjfile\fP as a file with the object
	68	code format \fIbfdname\fP.
	69
	70	.TP
	71	.B "\-O \fIbfdname\fP"
	72	.TP
	73	.B "\-\-output\-target=\fIbfdname"
	74	Replace \fIobjfile\fP with a file in the output format \fIbfdname\fP.
	75
	76	.TP
	77	.B "\-R \fIsectionname\fP"
	78	.TP
	79	.B "\-\-remove\-section=\fIsectionname"
	80	Remove the named section from the file. This option may be given more
	81	than once. Note that using this option inappropriately may make the
	82	object file unusable.
	83
	84	.TP
	85	.B \-s
	86	.TP
	87	.B \-\-strip\-all
	88	Remove all symbols.
	89
	90	.TP
	91	.B \-S
	92	.TP
	93	.B \-g
	94	.TP
	95	.B \-\-strip\-debug
	96	Remove debugging symbols only.
	97
	98	.TP
	99	.B \-\-strip\-unneeded
	100	Strip all symbols that are not needed for relocation processing.
	101
	102	.TP
	103	.B \-N \fIsymbolname\fR
	104	.TP
	105	.B \-\-strip\-symbol=\fIsymbolname
	106	Remove symbol \fIsymbolname\fP from the source file. This option
	107	may be given more than once, and may be combined with other strip
	108	options.
	109
	110	.TP
	111	.B \-o \fIfile\fR
	112	Put the stripped output in \fIfile\fR, rather than replacing the
	113	existing file. When this argument is used, only one \fIobjfile\fR
	114	argument may be specified.
	115
	116	.TP
	117	.B \-x
	118	.TP
	119	.B \-\-discard\-all
	120	Remove non-global symbols.
	121
	122	.TP
	123	.B \-X
	124	.TP
	125	.B \-\-discard\-locals
	126	Remove compiler-generated local symbols.
	127	(These usually start with ``L'' or ``.''.)
	128
	129	.TP
	130	.B \-K \fIsymbolname\fR, \fB\-\-keep\-symbol=\fIsymbolname
	131	Copy only symbol \fIsymbolname\fP from the source file. This option
	132	may be given more than once.
	133
	134	.TP
	135	.B \-N \fIsymbolname\fR, \fB\-\-strip\-symbol=\fIsymbolname
	136	Do not copy symbol \fIsymbolname\fP from the source file. This option
	137	may be given more than once, and may be combined with strip options
	138	other than \fB\-K\fR.
	139
	140	.TP
	141	.B \-v
	142	.TP
	143	.B \-\-verbose
	144	Verbose output: list all object files modified. In the case of
	145	archives,
	146	.B "strip \-V"
	147	lists all members of the archive.
	148
	149	.TP
	150	.B \-V
	151	.TP
	152	.B \-\-version
	153	Show the version number for \fBstrip\fP and exit.
	154
	155	.SH "SEE ALSO"
	156	.RB "`\\|" binutils "\\|'"
	157	entry in
	158	.BR info ;
	159	.IR "The GNU Binary Utilities" ,
	160	Roland H. Pesch (October 1991).
	161
	162	.SH COPYING
	163	Copyright (c) 1991 Free Software Foundation, Inc.
	164	.PP
	165	Permission is granted to make and distribute verbatim copies of
	166	this manual provided the copyright notice and this permission notice
	167	are preserved on all copies.
	168	.PP
	169	Permission is granted to copy and distribute modified versions of this
	170	manual under the conditions for verbatim copying, provided that the
	171	entire resulting derived work is distributed under the terms of a
	172	permission notice identical to this one.
	173	.PP
	174	Permission is granted to copy and distribute translations of this
	175	manual into another language, under the above conditions for modified
	176	versions, except that this permission notice may be included in
	177	translations approved by the Free Software Foundation instead of in
	178	the original English.