sigwait(3) ожидание сигнала

ОБЗОР

#include <signal.h>
int sigwait(const sigset_t *set, int *sig);

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

sigwait(): _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_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).