10.12 Sigprocmask function

In section 10.8 We mention that the mask of the process is a set of signals that the current blocking signal is sent to the process. A process can view its signal mask, change its signal mask, or perform both operations at the same time, by invoking the function Sigprocmask to achieve the above requirements.

  
 

   
  

  
#include <signal.h>
   
  

  
int sigprocmask(int how, const sigset_t *restrict set, sigset_t *restrict oset);
   
  

  
 return:0 if OK, -1 on error.
  
 

First, if Oset is a non-null pointer, the current process's signal mask will be returned through Oset.
Second, if set is a non-null pointer, the parameter how shows how the current signal mask is modified, and figure 10.13 describes the possible values for the parameter how. Sig_block is one or operation, while Sig_setmask is an assignment operation, note that Sigkill and Sigstop cannot be blocked.

How

	Description
Sig_block	The new signal mask is a combination of the current signal mask and the set of signals specified by the sets. That is, the set contains the extra signal we want to block.
Sig_unblock	The new signal mask is the intersection of the current signal mask and the complement set of the set signal set, that is, the set contains the signals we want to contact with blocking.
Sig_setmask	The new signal will be replaced by a set of incoming signal sets.

Figure 10.13 How to change the current signal mask using the function Sigprocmask

If set is a null pointer, the process's signal mask is not changed and the parameter how is ignored.
After calling the function Sigprocmask, if any of the signals that are not blocked are suspended, at least one of these signals is sent to the process before the Sigprocmask is returned.

The function sigprocmask is defined only for single-threaded processes, and for multithreaded processes the system provides another function to manipulate the signal mask of the thread, which we will discuss in 12.8.

Example

The function in Figure 10.14 is used to print the name in the signal mask of the calling process, and we will call the function in the program in Figure 10.20 and 10.22.

  
 

   
  

  
#include "apue.h"
   
  

  
#include <errno.h>
   
  

  

   
  

  
void pr_mask(const char *str)
   
  

  
{
   
  

  
 sigset_t sigset;
   
  

  
 int errno_save;
   
  

  

   
  

  
 errno_save = errno; /*we can be called by signal handlers*/
   
  

  

   
  

  
 if(sigprocmask(0, NULL, &sigset)<0)
   
  

  
 {
   
  

  
 err_ret("sigprocmask error");
   
  

  
 }
   
  

  
 else
   
  

  
 {
   
  

  
 printf("%s", str);
   
  

  
 if(sigismember(&sigset, SIGINT))
   
  

  
 printf(" SIGINT");
   
  

  
 if(sigismember(&sigset, SIGQUIT))
   
  

  
 printf(" SIGQUIT");
   
  

  
 if(sigismember(&sigset, SIGUSR1))
   
  

  
 printf(" SIHUSR1");
   
  

  
 if(sigismember(&sigset, SIGALRM))
   
  

  
 printf(" SIGALRM");
   
  

  

   
  

  
 /*remaining signals can go here */
   
  

  
 printf("\n");
   
  

  
 }
   
  

  

   
  

  
 errno = errno_save; /*restore errno*/
   
  

  
}
  
 

From for notes (Wiz)

10.12 Sigprocmask function