.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)setpgid.2	6.2 (Berkeley) 02/19/91
.\"
.TH SETPGRP 2 ""
.UC 4
.SH NAME
setpgid, setpgrp \- set process group
.SH SYNOPSIS
.ft B
setpgid(pid_t pid, pid_t pgrp);
.br
setpgrp(pid_t pid, pid_t pgrp);
.ft R
.SH DESCRIPTION
.I Setpgid
sets the process group of the specified process
.I pid
to the specified
.IR pgrp .
If
.I pid
is zero, then the call applies to the current process.
.PP
If the invoker is not the super-user, then the affected process
must have the same effective user-id as the invoker or be a descendant
of the invoking process.
.SH "RETURN VALUE
.I Setpgid
returns 0 when the operation was successful.
If the request failed, \-1 is returned and the global variable
.I errno
indicates the reason.
.SH ERRORS
.I Setpgid
will fail and the process group will not be altered if
one of the following occur:
.TP 15
[ESRCH]
The requested process does not exist.
.TP 15
[EPERM]
The effective user ID of the requested process is different
from that of the caller and the process is not a descendent
of the calling process.
.SH "SEE ALSO"
getpgrp(2)
.SH STANDARDS
.I Setpgid
conforms to IEEE Std 1003.1-1988 (``POSIX'').
.SH COMPATIBILITY
.I Setpgrp
is identical to
.IR setpgid ,
and is retained for calling convention compatibility with historical
versions of BSD.