table of contents
KILLPG(3) | Руководство программиста Linux | KILLPG(3) |
ИМЯ¶
killpg - послать сигнал группе процессов
СИНТАКСИС¶
#include <signal.h>
int killpg(int pgrp, int sig);
Требования
макроса
тестирования
свойств
для glibc (см.
feature_test_macros(7)):
- killpg():
- _XOPEN_SOURCE >= 500
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* версии glibc <= 2.19: */ _BSD_SOURCE
ОПИСАНИЕ¶
killpg() отправляет сигнал sig группе процессов pgrp. Список сигналов можно найти в signal(7).
Если значение pgrp равно 0, то killpg() отправляет сигнал вызывающей группе процессов (в POSIX: если значение pgrp меньше или равно 1, то поведение не определено).
Права, требуемые для отправки сигнала другому процессу, смотрите в kill(2).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.
ОШИБКИ¶
- EINVAL
- В sig задан неправильный номер сигнала.
- EPERM
- Процесс не имеет достаточно прав для отправки сигнала ни одному из группы процессов-получателей. Требуемые права смотрите в kill(2).
- ESRCH
- В группе процессов pgrp нет ни одного процесса.
- ESRCH
- Номер группы процессов равен 0, но процесс-отправитель не входит ни в какую группу процессов.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD, (killpg() впервые появился в 4BSD).
ЗАМЕЧАНИЯ¶
Есть некоторые различия между проверкой прав в системах BSD и System V. Смотрите в POSIX объяснение kill(). Различие не упомянуто в POSIX по отношению к возвращаемому значению EPERM: в BSD описано, что сигнал не послан и возвращается EPERM когда проверка прав не пройдена по крайней мере для одного процесса-получателя, в то время как в POSIX описано, что EPERM возвращается только когда проверка прав не пройдена для всех процессов-получателей.
Отличия между библиотекой C и ядром¶
В Linux killpg() реализован в виде библиотечной функции, которая вызывает kill(-pgrp, sig).
СМ. ТАКЖЕ¶
getpgrp(2), kill(2), signal(2), capabilities(7), credentials(7)
ЗАМЕЧАНИЯ¶
Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан Alex Nik <rage.iz.me@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
15 сентября 2017 г. | Linux |