X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=platform%2Fexample_64%2Finternals%2F_PDCLIB_config.h;h=ba3de27e9483dbfe8eb5e7f4e71323f8d703b453;hp=9ab6b2f8eae94b24b36886911fa2869d885e152e;hb=01c88bc38e78e9b2c47917b85b9b497187946e3c;hpb=3c7e677c7a6b43ce8bd12021e0af280f08009777 diff --git a/platform/example_64/internals/_PDCLIB_config.h b/platform/example_64/internals/_PDCLIB_config.h index 9ab6b2f..ba3de27 100644 --- a/platform/example_64/internals/_PDCLIB_config.h +++ b/platform/example_64/internals/_PDCLIB_config.h @@ -279,3 +279,38 @@ typedef int _PDCLIB_fd_t; */ #define _PDCLIB_UNGETCBUFSIZE 1 +/* Signals ------------------------------------------------------------------ */ + +/* A word on signals, to the people using PDCLib in their OS projects. + + The way they are defined by the C standard severely limits their usefulness, + to the point where a library implementation need not interface with the OS' + signals at all (which is what the PDCLib example implementation does). + (Other issues include, for example, that signal handlers are not re-entrant.) + + Thus, it is strongly discouraged to try bolting on a signal handling infra- + structure onto . Since C's signal handling is so limited to begin + with, and code using it is pretty much non-portable anyway, it would be + smarter to keep in the barely functional state it is in, and + instead create a better, OS-specific API. + + That being said, the below signals require to be defined to a positive int + value. I took what my Linux box defined them to; if you have to change them, + and what value to change them *to*, depends heavily on your environment and + what you are expecting to accomplish (see above). +*/ +#define _PDCLIB_SIGABRT 6 +#define _PDCLIB_SIGFPE 8 +#define _PDCLIB_SIGILL 4 +#define _PDCLIB_SIGINT 2 +#define _PDCLIB_SIGSEGV 11 +#define _PDCLIB_SIGTERM 15 + +/* The following should be defined to pointer values that could NEVER point to + a valid function. (They are used as special arguments to signal().) Again, I + took the values of my Linux box, which should be as good as any other value. +*/ +#define _PDCLIB_SIG_DFL (void (*)( int ))0 +#define _PDCLIB_SIG_ERR (void (*)( int ))-1 +#define _PDCLIB_SIG_IGN (void (*)( int ))1 +