killpg (2) Linux Manual Page
killpg – send signal to a process group
Synopsis
#include <signal.h>int killpg(int pgrp, int sig);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
- killpg():
- _XOPEN_SOURCE >= 500
|| /* Since glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versions <= 2.19: */ _BSD_SOURCE
Description
killpg() sends the signal sig to the process group pgrp. See signal(7) for a list of signals.If pgrp is 0, killpg() sends the signal to the calling process’s process group. (POSIX says: if pgrp is less than or equal to 1, the behavior is undefined.)
For the permissions required to send a signal to another process, see kill(2).
Return Value
On success, zero is returned. On error, -1 is returned, and errno is set appropriately.Errors
- EINVAL
- sig is not a valid signal number.
- EPERM
- The process does not have permission to send the signal to any of the target processes. For the required permissions, see kill(2).
- ESRCH
- No process can be found in the process group specified by pgrp.
- ESRCH
- The process group was given as 0 but the sending process does not have a process group.