From 0d2077dc935eeafeaebee0cad89ac20913587312 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 13 Jun 2001 08:40:23 +0000 Subject: [PATCH] * gdb.texinfo (Signals): Clarify the default setting of signal handling. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 12 +++++++++--- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index d89b700ba2..0f19bd97e4 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2001-06-13 Eli Zaretskii + + * gdb.texinfo (Signals): Clarify the default setting of signal + handling. + 2001-05-14 Andrew Cagney * gdbint.texinfo (CLEAR_DEFERRED_STORES): Delete stray @item diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 11a959a943..708d4f6b5b 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 -- 2.11.0