Add support for backtracing through signal handlers on Linux/ARM. Also,

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

diff --git a/binutils/strip.1 b/binutils/strip.1
index 2854304ee3cbb2073638c705d044818c8bd339d0..1fc415c8a78741937ab739ca60705b0c4de2c996 100644 (file)
--- a/binutils/strip.1
+++ b/binutils/strip.1
@@ -1,4 +1,4 @@
-.\" Copyright (c) 1991 Free Software Foundation
+.\" Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation
 .\" See section COPYING for conditions for redistribution
 .TH strip 1 "5 November 1991" "cygnus support" "GNU Development Tools"
 .de BP
@@ -11,17 +11,26 @@
 strip \- Discard symbols from object files.
 
 .SH SYNOPSIS
+.hy 0
+.na
+.TP
 .B strip
-.RB "[\|" "\-F \fIbfdname\fP" | \-\-target=\fIbfdname\fP "\|]"
-.RB "[\|" "\-I \fIbfdname\fP" | \-\-input\-target=\fIbfdname\fP "\|]"
-.RB "[\|" "\-O \fIbfdname\fP" | \-\-output\-target=\fIbfdname\fP "\|]"
-.RB "[\|" \-s | \-\-strip\-all "\|]"
-.RB "[\|" \-S | -g | \-\-strip\-debug "\|]"
-.RB "[\|" \-x | \-\-discard\-all "\|]"
-.RB "[\|" \-X | \-\-discard\-locals "\|]"
-.RB "[\|" \-v | \-\-verbose "\|]"
-.RB "[\|" \-V | \-\-version "\|]"
-.RB "[\|" \-V | \-\-help "\|]"
+.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\fR "\|]"
+.RB "[\|" \-p\fR\ |\ \fB\-\-preserve\-dates "\|]"
+.RB "[\|" \-v\fR\ |\ \fB\-\-verbose "\|]"
+.RB "[\|" \-V\fR\ |\ \fB\-\-version "\|]"
+.RB "[\|" \-V\fR\ |\ \fB\-\-help "\|]"
 .I objfile\c
 \&.\|.\|.
 
@@ -65,6 +74,14 @@ code format \fIbfdname\fP.
 .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
@@ -74,11 +91,35 @@ Remove all symbols.
 .TP
 .B \-S
 .TP
-.B -g
+.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 \-p
+.TP
+.B \-\-preserve-dates
+Preserve the access and modification dates of the file.
+
 .TP
 .B \-x
 .TP
@@ -86,17 +127,30 @@ Remove debugging symbols only.
 Remove non-global symbols.
 
 .TP
-.B "\-X \-\-discard\-locals"
+.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"
+.B "strip \-v"
 lists all members of the archive.
 
 .TP
@@ -109,7 +163,7 @@ Show the version number for \fBstrip\fP and exit.
 .RB "`\|" binutils "\|'" 
 entry in 
 .BR info ;
-.IR "The GNU Binary Utilities ,
+.IR "The GNU Binary Utilities" ,
 Roland H. Pesch (October 1991).
 
 .SH COPYING