killpg(3C) Standard C Library Functions killpg(3C)NAMEkillpg - 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
privileged 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)SunOS 5.10 24 Jul 2002 killpg(3C)