KILLPG(3C)KILLPG(3C)NAME
killpg - send signal to a process group
SYNOPSIS
#include <signal.h>
int killpg(pid_t pgrp, int sig);
DESCRIPTION
The killpg() function sends the signal sig to the process group pgrp.
See signal.h(3HEAD) for a list of signals.
The real or effective user ID of the sending process must match the
real or saved set-user ID of the receiving process, unless the effec‐
tive user ID of the sending process is the privileged user. A single
exception is the signal SIGCONT, which may always be sent to any
descendant of the current process.
RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, −1 is returned
and errno is set to indicate the error.
ERRORS
The killpg() function will fail and no signal will be sent if:
EINVAL
The sig argument is not a valid signal number.
EPERM
The effective user ID of the sending process is not privi‐
leged user, and neither its real nor effective user ID
matches the real or saved set-user ID of one or more of the
target processes.
ESRCH
No processes were found in the specified process group.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
├────────────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└────────────────────┴─────────────────┘
SEE ALSOkill(2), setpgrp(2), sigaction(2), signal.h(3HEAD), attributes(5),
standards(5)
Jul 24, 2002 KILLPG(3C)