NAME

killpg − send signal to a process group

SYNOPSIS

/usr/ucb/cc [ flag ... ] file ...

int killpg( pgrp, sig)
int pgrp;
int sig;

DESCRIPTION

killpg() sends the signal sig to the process group pgrp. See sigvec(3B) 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, a value of 0 is returned.  Otherwise, a value of −1 is returned and the global variable errno is set to indicate the error. 

ERRORS

killpg() will fail and no signal will be sent if any of the following occur:

EINVAL sig 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. 

SEE ALSO

kill(2), setpgrp(2), sigaction(2), sigvec(3B)

NOTES

Use of these interfaces should be restricted to only applications written on BSD platforms.  Use of these interfaces with any of the system libraries or in multi-thread applications is unsupported. 

SunOS 5.4  —  Last change: 12 Feb 1993