sigsuspend()

Блокироваться до тех пор, пока сигнал не вызовет обработчик сигнала

Прототип:

#include <signal.h>
int sigsuspend( const sigset_t *sigmask );

Аргументы:

sigmask
Указатель на объект sigset_t, определяющий новую маску сигналов.

Библиотека:

libc

Описание:

Функция sigsuspend() замещает маску сигналов потока на sigmask и приостанавливает его выполнение до поступления сигнала, реакция на который будет либо в вызове функции-обработчика, либо в терминировании потока.

Возвращаемое значение:

-1
Если функция возвращает управление; Код ошибки записан в errno.

Коды ошибок:

EFAULT
При обращении к буферу возникла ошибка.
EINTR
Вызывающий поток получил сигнал и возвращено управление из функции-обработчика.

Примеры:

/*
* 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);
}

Классификация:

POSIX 1003.1

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

pause(), pthread_sigmask(), sigaction(), sigpending(), sigprocmask()




Предыдущий раздел: Описание API системной библиотеки