sigsuspend()

Replace the signal mask, and then suspend the process

Synopsis:

#include <signal.h>

int sigsuspend( const sigset_t *sigmask );

Library:

libc

Description:

The sigsuspend() function replaces the process's signal mask with the set of signals pointed to by sigmask and then suspends the process until delivery of a signal whose action is either to execute a signal-catching function (then return), or to terminate the process.

Returns:

A value of -1 is returned (if the function returns), and errno is set.

Errors:

EFAULT

A fault occurred trying to access the buffers provided.

EINTR

A signal was caught by the calling process, and control is returned from the signal-catching function.

Examples:

/*
 * This program pauses until a signal other than
 * a SIGINT occurs. In this case a SIGALRM.
 */
#include <stdio.h>
#include <signal.h>
#include <stdlib.h>
#include <unistd.h>

sigset_t    set;

int main( void )
  {
    sigemptyset( &set );
    sigaddset( &set, SIGINT );

    printf( "Program suspended and immune to breaks.\n" );
    printf( "A SIGALRM will terminate the program"
        " in 10 seconds.\n" );
    alarm( 10 );
    sigsuspend( &set );
    return( EXIT_SUCCESS );
  }

Classification:

POSIX 1003.1

See also:

errno, pause(), sigaction(), sigpending(), sigprocmask()