pthread_kill(3)

НАИМЕНОВАНИЕ
pthread_kill - посылает сигнал в нить

БИБЛИОТЕКА
Библиотека потоков POSIX (libpthread, -lpthread)

ОБЗОР
#include <signal.h>

int pthread_kill(pthread_t thread, int sig);

    Требования макроса тестирования свойств для 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

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

В POSIX.1-2008 рекомендуется, что если реализация обнаруживает использование ID нити после её срока жизни, то pthread_kill() должна возвращать ошибку ESRCH. Реализация glibc возвращает эту ошибку в случае, когда обнаруживается некорректный ID нити. Но также заметим, что в POSIX говорится, что попытка использовать ID нити с завершённым сроком жизни приводит к непредсказуемому поведению, и попытка использовать некорректный ID нити в вызове pthread_kill() может приводить, например, к ошибке сегментирования.

СТАНДАРТЫ
POSIX.1-2008.

ИСТОРИЯ
POSIX.1-2001.

ПРИМЕЧАНИЯ
Область действия сигнала — весь процесс: если установлен обработчик сигнала, то он будет вызван в нити thread, но если этот сигнал «stop», «continue» или «terminate», то это действие повлияет на весь процесс.

СМОТРИТЕ ТАКЖЕ
kill(2), sigaction(2), sigpending(2), pthread_self(3), pthread_sigmask(3), raise(3), pthreads(7), signal(7)

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) Alexey, Azamat Hackimov <azamat.hackimov@gmail.com>, kogamatranslator49 <r.podarov@yandex.ru>, Darima Kogan <silverdk99@gmail.com>, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (<debian-l10n-russian@lists.debian.org>).