table of contents
KILLPG(2) | Руководство программиста Linux | KILLPG(2) |
ИМЯ¶
killpg - послать сигнал группе процессов
ОБЗОР¶
#include <signal.h>
int killpg(int pgrp, int sig);
Требования
макроса
тестирования
свойств
для glibc (см.
feature_test_macros(7)):
- killpg():
- _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
ОПИСАНИЕ¶
killpg() отправляет сигнал sig группе процессов pgrp. Список сигналов можно найти в signal(7).
Если значение pgrp равно 0, то killpg() отправляет сигнал вызывающей группе процессов. (В POSIX: если значение pgrp меньше или равно 1, поведение не определено.)
Чтобы процесс мог посылать сигнал, он должен быть привилегированным (в Linux: иметь мандат CAP_KILL), либо реальный или эффективный идентификатор пользователя посылающего процесса должен быть равен реальному или сохранённому идентификатору пользователя процесса, которому отправляется сигнал. Для сигнала SIGCONT посылающий и получающий процессы должны принадлежать одному сеансу.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.
ОШИБКИ¶
- EINVAL
- В Sig задан неправильный номер сигнала.
- EPERM
- Процесс не имеет достаточно прав для отправки сигнала ни одному из группы процессов-получателей.
- ESRCH
- В группе процессов pgrp нет ни одного процесса.
- ESRCH
- Номер группы процессов равен 0, но процесс-отправитель не входит ни в какую группу процессов.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
SVr4, 4.4BSD (функция killpg() первые появилась в 4BSD), POSIX.1-2001.
ЗАМЕЧАНИЯ¶
Есть некоторые различия между проверкой прав в системах BSD и System V. Смотрите в POSIX объяснение kill(). Различие не упомянуто в POSIX по отношению к возвращаемому значению EPERM: в BSD описано, что сигнал не послан и возвращается EPERM когда проверка прав не пройдена по крайней мере для одного процесса-получателя, в то время как в POSIX описано, что EPERM возвращается только когда проверка прав не пройдена для всех процессов-получателей.
В Linux killpg() реализован в виде библиотечной функции, которая вызывает kill(-pgrp, sig).
СМОТРИТЕ ТАКЖЕ¶
getpgrp(2), kill(2), signal(2), capabilities(7), credentials(7)
2010-09-20 | Linux |