NAME

killpg − send signal to a process group

SYNOPSIS

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

int killpg(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)

SunOS 5.1/x86  —  Last change: 5 Jul 1990