Examine or change the signal mask for a thread
#include <signal.h> int sigprocmask( int how, const sigset_t *set, sigset_t *oset );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The sigprocmask() function is used to examine or change (or both) the signal mask for the calling thread. If the value of set isn't NULL, it points to a set of signals to be used to change the currently blocked set.
The set argument isn't changed. The resulting set is maintained in the process table of the calling thread. If a signal occurs on a signal that's masked, it becomes pending, but doesn't affect the execution of the process. You can examine pending signals by calling sigpending(). When a pending signal is unmasked, it's acted upon immediately, before this function returns.
When a signal handler is invoked, the signal responsible is automatically masked before its handler is called. If the handler returns normally, the operating system restores the signal mask present just before the handler was called as an atomic operation. Changes made using sigprocmask() in the handler are undone.
The sigaction() function lets you specify any mask that's applied before a handler is invoked. This can simplify multiple signal handler design.
To maintain code portability, use pthread_sigmask() in a multithreaded application. |
#include <stdio.h> #include <stdlib.h> #include <signal.h> #include <unistd.h> int main( void ) { sigset_t set, oset, pset; sigemptyset( &set ); sigaddset( &set, SIGINT ); sigprocmask( SIG_BLOCK, &set, &oset ); printf( "Old set was %8.8ld.\n", oset ); sigpending( &pset ); printf( "Pending set is %8.8ld.\n", pset ); kill( getpid(), SIGINT ); sigpending( &pset ); printf( "Pending set is %8.8ld.\n", pset ); sigprocmask( SIG_UNBLOCK, &set, &oset ); /* The program terminates with a SIGINT */ return( EXIT_SUCCESS ); }
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |
kill(), pthread_sigmask(), raise(), sigaction(), sigaddset(), sigdelset(), sigemptyset(), sigfillset(), sigismember(), signal(), SignalProcmask(), sigpending()