Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



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

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).