1========================================================= 2:mod:`PyObjCTools.Signals` -- Debug signal handling 3========================================================= 4 5.. module:: PyObjCTools.Signals 6 :synopsis: Debug signal handling 7 8This module provides two functions that can be useful while investigating 9random crashes of a PyObjC program. These crashes are often caused by 10Objective-C style weak references or incorrectly implemented protocols. 11 12.. function:: dumpStackOnFatalSignal() 13 14 This function will install signal handlers that print a stack trace and 15 then re-raise the signal. 16 17.. function:: resetFatalSignals() 18 19 Restores the signal handlers to the state they had before the call to 20 dumpStackOnFatalSignal. 21 22This module is not designed to provide fine grained control over signal 23handling. Nor is it intended to be terribly robust. It may give useful 24information when your program gets unexpected signals, but it might just 25as easily cause a crash when such a signal gets in.