diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index e3eb26f0f..9cff0e4d3 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,7 @@ +2015-08-03 Jon Turney + + * faq-programming.xml: Improve debugging-cygwin answer. + 2015-07-21 Corinna Vinschen * new-features.xml (ov-new2.2): Document sigsetjmp, siglongjmp. diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml index 491da5dbf..0c936ebd6 100644 --- a/winsup/doc/faq-programming.xml +++ b/winsup/doc/faq-programming.xml @@ -747,14 +747,32 @@ same time. Remove all but one. I may have found a bug in Cygwin, how can I debug it (the symbols in gdb look funny)? -Debugging symbols are stripped from distibuted Cygwin binaries, so any -symbols that you see in gdb are basically meaningless. It is also a good +Debugging symbols are stripped from distibuted Cygwin binaries, so to +debug with gdb you will need to install the +cygwin-debuginfo package to obtain the debug symbols for +cygwin1.dll + + + +If your bug causes an exception inside cygwin1.dll you will +need to use the gdb command set cygwin-exceptions +on to tell gdb to stop on exceptions inside the +Cygwin DLL (by default they are ignored, as they may be generated during normal +operation e.g. when checking a pointer is valid) + + + +It is also a good idea to use the latest code in case the bug has been fixed, so we recommend trying the latest snapshot from - or building the DLL from GIT. + or building the DLL from git. + To build a debugging version of the Cygwin DLL, you will need to follow -the instructions at . +the instructions at . + + + You can also contact the mailing list for pointers (a simple test case that demonstrates the bug is always welcome).