diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml index 0c936ebd6..18557c0d1 100644 --- a/winsup/doc/faq-programming.xml +++ b/winsup/doc/faq-programming.xml @@ -859,15 +859,22 @@ on using strace, see the Cygwin User's Guide. -Why doesn't gdb handle signals? +How does gdb handle signals? -Unfortunately, there is only minimal signal handling support in gdb -currently. Signal handling only works with Windows-type signals. -SIGINT may work, SIGFPE may work, SIGSEGV definitely does. You cannot -'stop', 'print' or 'nopass' signals like SIGUSR1 or SIGHUP to the -process being debugged. + +gdb maps known Windows exceptions to signals such as SIGSEGV, SIGFPE, SIGTRAP, +SIGINT and SIGILL. Other Windows exceptions are passed on to the handler (if +any), and reported as an unknown signal if an unhandled (second chance) +exception occurs. + + +There is also an experimental feature to notify gdb of purely Cygwin signals +like SIGABRT, SIGHUP or SIGUSR1. This currently has some known problems, for +example, single-stepping from these signals may not work as expected. + +