xref: /original-bsd/lib/libc/compat-43/killpg.2 (revision 0fc6f013)
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.3 (Berkeley) 05/14/86

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, or the sender must be 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 in the process group specified by pgrp.

15 [ESRCH] The process group was given as 0 but the sending process does not have a process group.

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)