Skip to content

Commit 85df945

Browse files
committed
gdb/doc: extend the documentation for the 'handle' command
The documentation for the 'handle' command does not cover all of the features of the command, and in one case, is just wrong. The user can specify 'all' as signal name, the documentation implies that this will change the behaviour of all signals, in reality, this changes all signals except SIGINT and SIGTRAP (the signals used by GDB). I've updated the docs to list this limitation. The 'handle' command also allows the user to specify multiple signals for a single command, e.g. 'handle SIGFPE SIGILL nostop pass print', however the documentation doesn't describe this, so I've updated the docs to describe this feature.
1 parent 8478900 commit 85df945

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

gdb/doc/gdb.texinfo

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6760,13 +6760,14 @@ Set a catchpoint for the indicated signals. @xref{Set Catchpoints},
67606760
for details about this command.
67616761

67626762
@kindex handle
6763-
@item handle @var{signal} @r{[}@var{keywords}@dots{}@r{]}
6764-
Change the way @value{GDBN} handles signal @var{signal}. The @var{signal}
6765-
can be the number of a signal or its name (with or without the
6766-
@samp{SIG} at the beginning); a list of signal numbers of the form
6767-
@samp{@var{low}-@var{high}}; or the word @samp{all}, meaning all the
6768-
known signals. Optional arguments @var{keywords}, described below,
6769-
say what change to make.
6763+
@item handle @var{signal} @r{[} @var{signal} @dots{} @r{]} @r{[}@var{keywords}@dots{}@r{]}
6764+
Change the way @value{GDBN} handles each @var{signal}. Each
6765+
@var{signal} can be the number of a signal or its name (with or
6766+
without the @samp{SIG} at the beginning); a list of signal numbers of
6767+
the form @samp{@var{low}-@var{high}}; or the word @samp{all}, meaning
6768+
all the known signals, except @code{SIGINT} and @code{SIGTRAP}, which
6769+
are used by @value{GDBN}. Optional argument @var{keywords}, described
6770+
below, say what changes to make to all of the specified signals.
67706771
@end table
67716772

67726773
@c @group

0 commit comments

Comments
 (0)