PTHREAD_SIGQUEUE(3)

ИМЯ
pthread_sigqueue - вставляет сигнал и данные в очередь нити

ОБЗОР
#include <signal.h>
#include <pthread.h>
int pthread_sigqueue(pthread_t thread, int sig,
                     const union sigval value);

Компилируется и компонуется вместе с -pthread.

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

pthread_sigqueue(): _GNU_SOURCE

ОПИСАНИЕ
Функция pthread_sigqueue() выполняет схожу с sigqueue(3) задачу, но посылает сигнал не процессу, а нити из того же процесса, что и вызвавшая функцию нить. В аргументе thread указывается ID нити в том же процессе, что и вызывающий. В аргументе sig задаётся отправляемый сигнал. В аргументе value указываются данные, прилагаемые к сигналу; подробности смотрите в sigqueue(3).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении pthread_sigqueue() возвращается 0; при ошибке возвращается номер ошибки.

ОШИБКИ

EAGAIN
    Достигнуто ограничение на количество сигналов в очереди (подробней об этом смотрите в signal(7)).

EINVAL
    Значение sig некорректно.

ENOSYS
    Функция pthread_sigqueue() не поддерживается в этой системе.

ESRCH
    Некорректное значение thread.

ВЕРСИИ
Функция pthread_sigqueue() впервые появилась в glibc 2.11.

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

СООТВЕТСТВИЕ СТАНДАРТАМ
Эта функция является расширением GNU.

ЗАМЕЧАНИЯ
Реализация pthread_sigqueue() в glibc выдаёт ошибку (EINVAL) при попытке послать сигналы реального времени, которые используются внутри реализации NPTL. Подробности смотрите в nptl(7).

СМОТРИТЕ ТАКЖЕ
rt_tgsigqueueinfo(2), sigaction(2), pthread_sigmask(3), sigqueue(3), sigwait(3), pthreads(7), signal(7)