usr/src/lib/libc/compat-43/killpg.2

.\" 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.1 (Berkeley) %G%
.\"
.TH KILLPG 2 ""
.UC 4
.SH NAME
killpg \- send signal to a process group
.SH SYNOPSIS
.ft B
killpg(pgrp, sig)
.br
int pgrp, sig;
.ft R
.SH DESCRIPTION
.I Killpg
sends the signal
.I sig
to the process group
.IR pgrp .
See
.IR sigvec (2)
for a list of signals.
.PP
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 which is a descendant of the current process.
.SH "RETURN VALUE
Upon successful completion, a value of 0 is returned.  Otherwise,
a value of \-1 is returned and the global variable \fIerrno\fP
is set to indicate the error.
.SH "ERRORS
\fIKillpg\fP will fail and no signal will be sent if any of the
following occur:
.TP 15
[EINVAL]
\fISig\fP is not a valid signal number.
.TP 15
[ESRCH]
No process can be found corresponding to that specified by \fIpid\fP.
.TP 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.
.SH "SEE ALSO"
kill(2), getpgrp(2), sigvec(2)