KILL(2)

ИМЯ
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-2001, POSIX.1-2008, SVr4, 4.3BSD.

ЗАМЕЧАНИЯ
Процессу init с идентификатором 1 можно послать только те сигналы, для которых он явно установил обработчики сигналов. Так сделано, чтобы быть уверенным, что в случае какой-либо нештатной ситуации работа системы не будет завершена аварийно.

В 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)