killpg(3C)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also

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(5) 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(5), standards(5)

SunOS 5.11  Last Revised 24 Jul 2002

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also