KILLPG(3C) Standard C Library Functions 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
effective 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
kill(2),
setpgrp(2),
sigaction(2),
signal.h(3HEAD),
attributes(7),
standards(7) July 24, 2002 KILLPG(3C)
