xroche/coffeecatch

CoffeeCatch is a tiny native POSIX signal catcher designed to gracefully recover from signals such as SIGSEGV and SIGBUS by treating them as exceptions. It is particularly useful for JNI code on Android/Dalvik but can also be used in non-Java C projects. The library provides simple macros (COFFEE_TRY, COFFEE_CATCH, COFFEE_END) to protect code sections. In JNI environments, the COFFEE_TRY_JNI macro automatically throws a Java exception upon catching a signal. While it handles most gentle crashes (null pointer dereferencing, integer division, stack overflow), it does not recover from allocator or mutex corruption. The handler is thread-safe, but the client must have exclusive control over signal handlers. For best stack traces, libraries should be compiled with -funwind-tables.