xref: /csrg-svn/lib/libc/compat-43/killpg.2 (revision 23812)
Copyright (c) 1980 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)killpg.2 6.2 (Berkeley) 06/28/85

KILLPG 2 ""
C 4
NAME
killpg - send signal to a process group
SYNOPSIS
killpg(pgrp, sig)

int pgrp, sig;

DESCRIPTION
Killpg sends the signal sig to the process group pgrp . See sigvec (2) for a list of signals.

The sending process and members of the process group must have the same effective user ID, otherwise this call is restricted to the super-user. As a single special case the continue signal SIGCONT may be sent to any process that is a descendant of the current process.

"RETURN VALUE
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:

15 [EINVAL] Sig is not a valid signal number.

15 [ESRCH] No process can be found corresponding to that specified by pid.

15 [EPERM] The sending process is not the super-user and one or more of the target processes has an effective user ID different from that of the sending process.

"SEE ALSO"
kill(2), getpgrp(2), sigvec(2)