НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

Standard C library (libc, -lc)

ОБЗОР

#include <signal.h>

int kill(pid_t pid, int sig);

kill():

    _POSIX_C_SOURCE

ОПИСАНИЕ

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

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

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

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

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

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

For a process to have permission to send a signal, it must either be privileged (under Linux: have the CAP_KILL capability in the user namespace of the target process), or the real or effective user ID of the sending process must equal the real or saved set-user-ID of the target process. In the case of SIGCONT, it suffices when the sending and receiving processes belong to the same session. (Historically, the rules were different; see HISTORY.)

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

On success, zero is returned. If signals were sent to a process group, success means that at least one signal was delivered. On error, -1 is returned, and errno is set to indicate the error.

ОШИБКИ

EINVAL

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

EPERM

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

ESRCH

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

СТАНДАРТЫ

POSIX.1-2008.

ИСТОРИЯ

POSIX.1-2001, SVr4, 4.3BSD.

ПРИМЕЧАНИЯ

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

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

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

ОШИБКИ

In Linux 2.6 up to and including Linux 2.6.7, there was a bug that meant that when sending signals to a process group, kill() failed with the error EPERM if the caller did not have permission to send the signal to any (rather than all) of the members of the process group. Notwithstanding this error return, the signal was still delivered to all of the processes for which the caller had permission to signal.

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

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

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Alex Nik <rage.iz.me@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

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

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