This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
[PATCH] Clarify the default handling of signals
- To: gdb-patches at sources dot redhat dot com
- Subject: [PATCH] Clarify the default handling of signals
- From: Eli Zaretskii <eliz at is dot elta dot co dot il>
- Date: Wed, 13 Jun 2001 11:44:23 +0300 (IDT)
FYI: I've just committed the patch below, to clarify how the signals are
handled by default. (The previous text made it sound as if non-fatal
signals were set to `ignore', i.e. `nopass', which is not true.)
2001-06-13 Eli Zaretskii <eliz@is.elta.co.il>
* gdb.texinfo (Signals): Clarify the default setting of signal
handling.
--- gdb/doc/gdb.t~0 Mon Apr 2 11:18:58 2001
+++ gdb/doc/gdb.texinfo Wed Jun 13 09:46:30 2001
@@ -3454,8 +3454,9 @@
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 @@
@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 @@
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