ИМЯ

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

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