killpg()

Отправить сигнал группе процессов

Прототип:

#include <sys/types.h>
#include <signal.h>
int killpg( pid_t pgrp,
int sig );

Аргументы:

pgrp
ID группы процессов, которым будет отправлен сигнал.
sig
0, или сигнал, который будет отправлен. Полный список сигналов представлен в POSIX signals.

Библиотека:

libc

Описание:

Функция killpg() отправляет сигнал sig группе процессов, c заданным pgrp. Если sig равен 0, сигнал не отправляется, но pgrp всё ещё проверяется на допустимость.

Если pgrp больше чем 1, вызов killpg( pgrp, sig ) эквивалентен вызову kill( −pgrp, sig ).

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EAGAIN
Недостаточно системных ресурсов для передачи сигнала.
EINVAL
Сигнал sig недопустим или не поддерживается.
EPERM
Процесс не имеет прав на отправку сигналов ни одному из указанных процессов.
ESRCH
Процессы с заданным pgrp не были обнаружены или pgrp меньше или равен 1.

Примеры:

См. sigprocmask()

Классификация:

POSIX 1003.1 XSI

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

getpid(), kill(), setsid(), sigaction(), signal(), SignalKill(), sigqueue()




Предыдущий раздел: Описание API системной библиотеки