summaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2001-06-13 08:40:23 +0000
committerEli Zaretskii <eliz@gnu.org>2001-06-13 08:40:23 +0000
commit0d2077dc935eeafeaebee0cad89ac20913587312 (patch)
treed4ef8c3ee1022c97edef85cd58d4bc4ecfa7e15c /gdb
parent2fdcda5a56111761e1880d4ccb8ffb40b422c227 (diff)
downloadgdb-0d2077dc935eeafeaebee0cad89ac20913587312.tar.gz
* gdb.texinfo (Signals): Clarify the default setting of signal
handling.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo12
2 files changed, 14 insertions, 3 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index d89b700ba28..0f19bd97e46 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2001-06-13 Eli Zaretskii <eliz@is.elta.co.il>
+
+ * gdb.texinfo (Signals): Clarify the default setting of signal
+ handling.
+
2001-05-14 Andrew Cagney <ac131313@redhat.com>
* gdbint.texinfo (CLEAR_DEFERRED_STORES): Delete stray @item
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 11a959a9437..708d4f6b5bc 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -3454,8 +3454,9 @@ program. You can tell @value{GDBN} in advance what to do for each kind of
signal.
@cindex handling signals
-Normally, @value{GDBN} is set up to ignore non-erroneous signals like @code{SIGALRM}
-(so as not to interfere with their role in the functioning of your program)
+Normally, @value{GDBN} is set up to let the non-erroneous signals like
+@code{SIGALRM} be silently passed to your program
+(so as not to interfere with their role in the program's functioning)
but to stop your program immediately whenever an error signal happens.
You can change these settings with the @code{handle} command.
@@ -3473,7 +3474,7 @@ the defined types of signals.
@item handle @var{signal} @var{keywords}@dots{}
Change the way @value{GDBN} handles signal @var{signal}. @var{signal}
can be the number of a signal or its name (with or without the
-@samp{SIG} at the beginning); a list of signal numberss of the form
+@samp{SIG} at the beginning); a list of signal numbers of the form
@samp{@var{low}-@var{high}}; or the word @samp{all}, meaning all the
known signals. The @var{keywords} say what change to make.
@end table
@@ -3519,6 +3520,11 @@ after @value{GDBN} reports a signal, you can use the @code{handle}
command with @code{pass} or @code{nopass} to control whether your
program sees that signal when you continue.
+The default is set to @code{nostop}, @code{noprint}, @code{pass} for
+non-erroneous signals such as @code{SIGALRM}, @code{SIGWINCH} and
+@code{SIGCHLD}, and to @code{stop}, @code{print}, @code{pass} for the
+erroneous signals.
+
You can also use the @code{signal} command to prevent your program from
seeing a signal, or cause it to see a signal it normally would not see,
or to give it any signal at any time. For example, if your program stopped