ИМЯ

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

СООТВЕТСТВИЕ СТАНДАРТАМ

Эта функция является расширением GNU.

ЗАМЕЧАНИЯ

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

СМОТРИТЕ ТАКЖЕ

rt_tgsigqueueinfo(2), sigaction(2), pthread_sigmask(3), sigqueue(3), sigwait(3), pthreads(7), signal(7)