SIGWAIT(3)

ИМЯ
sigwait - ожидание сигнала

ОБЗОР
#include <signal.h>

 int sigwait(const sigset_t *set, int *sig);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

sigwait():
    начиная с glibc 2.26:
        _POSIX_C_SOURCE >= 199506L
    в glibc 2.25 и старее:
        _POSIX_C_SOURCE

ОПИСАНИЕ
Функция sigwait() приостанавливает выполнение вызвавшей нити до тех пор, пока в ожидании не появится сигнал из заданного набора сигналов set. Функция принимает сигнал (удаляет его из списка ожидающих сигналов) и возвращает номер сигнала в sig.

Действие sigwait() тоже, что и sigwaitinfo(2), за исключением:

*   Функция sigwait() возвращает только номер сигнала, а не структуру siginfo_t, описывающую сигнал.

*   Функции отличаются возвращаемыми значениями.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении sigwait() возвращает 0. При ошибке возвращается положительный номер ошибки (перечислены в разделе ОШИБКИ).

ОШИБКИ

EINVAL
    В set содержится некорректный номер сигнала.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
sigwait() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ
Функция sigwait() реализована с помощью sigtimedwait(2).

В реализации glibc sigwait() просто игнорирует попытки ожидания двух сигналов реального времени, которые используются внутри реализации NPTL. Подробности смотрите в nptl(7).

ПРИМЕР
Смотрите pthread_sigmask(3).

СМОТРИТЕ ТАКЖЕ
sigaction(2), signalfd(2), sigpending(2), sigsuspend(2), sigwaitinfo(2), sigsetops(3), signal(7)