Scroll to navigation

TKILL(2) Руководство программиста Linux TKILL(2)

ИМЯ

tkill, tgkill - посылает сигнал нити

СИНТАКСИС

int tkill(int tid, int sig);
int tgkill(int tgid, int tid, int sig);

Замечание: В glibc нет обёрточной функции для tkill(); смотрите ЗАМЕЧАНИЯ.

ОПИСАНИЕ

tgkill() отправляет сигнал sig нити с ID tid в группе нитей tgid. Для сравнения, kill(2) может быть использована только для отправки сигнала процессу (т.е., группе нитей) как единому целому и сигнал будет доставлен произвольной нити внутри этого процесса.

Вызов tkill() — устаревший предшественник tgkill(). Он позволяет задавать только идентификатор нити-получателя, что может привести к уведомлению не той нити, если нить завершила работу и её идентификатор используется повторно. Не используйте данный системный вызов.

Это вызовы интерфейса системного уровня, они предназначены для внутреннего использования в библиотеке нитей.

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

При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.

ОШИБКИ

Достигнут ограничитель ресурса RLIMIT_SIGPENDING и sig содержит сигнал реального времени.
Недостаточное количество памяти ядра и sig содержит сигнал реального времени.
Указан некорректный идентификатор нити, группы или сигнал.
Отказано в доступе. См. kill(2) для получения подробностей о необходимом доступе.
Не существует процесса с указанным идентификатором нити (и идентификатором группы).

ВЕРСИИ

tkill() поддерживается начиная с Linux 2.4.19/2.5.4. tgkill() был добавлен в Linux 2.5.75.

Поддержка tgkill() добавлена в glibc версии 2.30.

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

Вызовы tkill() и tgkill() есть только в Linux, и они не должны использоваться в переносимых программах.

ЗАМЕЧАНИЯ

См. описание CLONE_THREAD в clone(2) для пояснения по поводу групп нитей.

В glibc нет обёртки для tkill(); запускайте его с помощью syscall(2). Также, до glibc 2.30 не было обёртки tgkill().

СМ. ТАКЖЕ

clone(2), gettid(2), kill(2), rt_sigqueueinfo(2)

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

2 августа 2019 г. Linux