ИМЯ

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

БИБЛИОТЕКА

Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС

#include <signal.h>           /* определения констант SIG* */
#include <sys/syscall.h>      /* определения констант SYS_* */
#include <unistd.h>

[[deprecated]] int syscall(SYS_tkill, pid_t tid, int sig);

#include <signal.h>

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

Note: glibc provides no wrapper for tkill(), necessitating the use of syscall(2).

ОПИСАНИЕ

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

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

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

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

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

ОШИБКИ

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

СТАНДАРТЫ

Linux.

ИСТОРИЯ

tkill(): Linux 2.4.19 / 2.5.4.
tgkill(): Linux 2.5.75, glibc 2.30.

ПРИМЕЧАНИЯ

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

ПЕРЕВОД

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

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

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

ИМЯ