ОБЗОР
#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).