Return to setpgrp.2 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys

BSD 4.3reno

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)setpgrp.2	6.1 (Berkeley) 5/9/85
.\"
.TH SETPGRP 2 "May 9, 1985"
.UC 4
.SH NAME
setpgrp \- set process group
.SH SYNOPSIS
.ft B
setpgrp(pid, pgrp)
.br
int pid, pgrp;
.ft R
.SH DESCRIPTION
.I Setpgrp
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 Setpgrp
returns when the operation was successful.  If
the request failed, \-1 is returned and the global
variable
.I errno
indicates the reason.
.SH ERRORS
.I Setpgrp
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)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.