Linux repositories inspector

pthread_kill(3) - Russkiy

Linux
2017-09-15

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

pthread_kill - посылает сигнал в нить

ОБЗОР

#include <signal.h>

int pthread_kill(pthread_t thread, int sig);
Компилируется и компонуется вместе с -pthread.
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
pthread_kill():
_POSIX_C_SOURCE >= 199506L || _XOPEN_SOURCE >= 500

ОПИСАНИЕ

Функция pthread_kill() посылает сигнал sig в thread — нить из того же процесса, что и вызвавший функцию. Сигнал доставляется thread асинхронно.
Если sig равно 0, то сигнал не посылается, но выполняется проверка на ошибки.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении pthread_kill() возвращается 0; при ошибке возвращается номер ошибки и сигнал не посылается.

ОШИБКИ

EINVAL Указан некорректный сигнал.

АТРИБУТЫ

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

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

POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ

Область действия сигнала — весь процесс: если установлен обработчик сигнала, то он будет вызван в нити thread, но если этот сигнал «stop», «continue» или «terminate», то это действие повлияет на весь процесс.
Реализация sigaction() в glibc выдаёт ошибку (EINVAL) при попытке послать сигналы реального времени, которые используются внутри реализации NPTL. Подробности смотрите в nptl(7).
В POSIX.1-2008 рекомендуется, что если реализация обнаруживает использование ID нити после её срока жизни, то pthread_kill() должна возвращать ошибку ESRCH. Реализация glibc возвращает эту ошибку в случае, когда обнаруживается некорректный ID нити. Но также заметим, что в POSIX говорится, что попытка использовать ID нити с завершённым сроком жизни приводит к непредсказуемому поведению, и попытка использовать некорректный ID нити в вызове pthread_kill() может приводить, например, к ошибке сегментирования.
⇧ Top