From mboxrd@z Thu Jan 1 00:00:00 1970 From: Eli Zaretskii To: gdb-patches@sources.redhat.com Subject: [PATCH] Clarify the default handling of signals Date: Wed, 13 Jun 2001 01:43:00 -0000 Message-id: X-SW-Source: 2001-06/msg00253.html 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 * 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