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)