ИМЯ

kill - послать сигнал процессу

ОБЗОР

#include <sys/types.h>
#include <signal.h>

int kill(pid_t pid, int sig);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

kill(): _POSIX_C_SOURCE

ОПИСАНИЕ

Системный вызов kill() может быть использован для посылки какого-либо сигнала
какому-либо процессу или группе процессов.

Если значение pid является положительным, то сигнал sig посылается процессу с
идентификатором pid.

Если значение pid равно 0, то sig посылается каждому процессу, который входит в
группу вызывающего процесса.

Если значение pid равно -1, то sig посылается каждому процессу, которым вызывающий
процесс имеет право отправлять сигналы, за исключением процесса с номером 1
(init), подробности смотрите далее.

Если значение pid меньше -1, то sig посылается каждому процессу, который входит в
группу процессов, чей ID равен -pid.

Если значение sig равно 0, то никакой сигнал не посылается, но выполняется
проверка существования и права; это можно использовать для проверки существования
процесса или группы процессов с заданным ID и допустимости отправки сигнала
вызывающим.

Чтобы процесс мог посылать сигнал, он должен быть привилегированным (в Linux:
иметь мандат CAP_KILL в пользовательском пространстве имён процесса назначения),
либо реальный или эффективный идентификатор пользователя посылающего процесса
должен быть равен реальному или сохранённому идентификатору пользователя процесса,
которому отправляется сигнал. Для сигнала SIGCONT посылающий и получающий процессы
должны принадлежать одному сеансу (сложилось исторически; правила разные; смотрите
ЗАМЕЧАНИЯ).

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

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

ОШИБКИ

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

EPERM Процесс не имеет достаточно прав для отправки сигнала ни одному из группы
процессов-получателей.

ESRCH Процесс или группа процессов не существует. Заметим, что существующий
процесс может быть в состоянии зомби — процесс, завершивший выполнение, но
которого ещё не дождались с помощью wait(2).

В POSIX.1 требуется, чтобы kill(-1,sig) посылал sig всем процессам, которым
вызывающий процесс может послать сигналы, возможно за исключением некоторых
процессов, определяемых реализацией системы. Linux позволяет процессу послать
сигнал самому себе, но при вызове kill(-1,sig) вызывающий процесс сигнала не
получит.

В POSIX.1 говорится, что если процесс посылает себе сигнал и посылающая нить не
блокирует сигнал, и нет ещё нити, которая его не блокирует или не ждёт его с
помощью sigwait(3), то, по крайней мере, один незаблокированный сигнал должен быть
доставлен посылающей нити до возврата из kill().

Замечания, касающиеся Linux
В различных версиях ядра Linux применяются разные правила, касающиеся прав
доступа, которые требуются для непривилегированного процесса, чтобы посылать
сигнал другому процессу. В ядрах с 1.0 по 1.2.2 сигнал может быть послан, если
эффективный идентификатор пользователя отправителя совпадает с эффективным
идентификатором пользователя цели или реальный идентификатор пользователя
отправителя совпадает с реальным идентификатором пользователя цели. В ядрах с
версии 1.2.3 по 1.3.77 сигнал может быть послан, если эффективный идентификатор
пользователя отправителя совпадает или с реальным или с эффективным
идентификатором пользователя цели. Текущие правила, которые соответствуют
стандартам POSIX.1, были введены, начиная с ядра версии 1.3.78.

ДЕФЕКТЫ

В ядрах 2.6 до 2.6.7 включительно есть дефект: когда посылаются сигналы группе
процессов, вызов kill() завершается с ошибкой EPERM, если вызывающий не имеет
право посылать сигнал любому (но не всем) члену группы процессов. Хотя
возвращается ошибка, сигнал всё равно доставляется всем процессам, которым
вызывающий имеет право послать сигнал.

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

kill(1), _exit(2), signal(2), tkill(2), exit(3), killpg(3), sigqueue(3),
capabilities(7), credentials(7), signal(7)