setgroups.2

<B>Digital的Unix操作系统VAX 4.2源码</B>

.\" SCCSID: @(#)setgroups.2	8.1	9/11/90
.TH setgroups 2
.SH Name
setgroups \- set group access list
.SH Syntax
.nf
.ft B
#include <sys/param.h>
.PP
.ft B
setgroups(ngroups, gidset)
int ngroups, *gidset;
.fi
.SH Description
.NXR "setgroups system call"
.NXR "group access list" "setting"
The
.PN setgroups
system call sets the group access list of the current user process
according to the array,
.IR gidset .
The
.I ngroups
parameter indicates the number of entries in the array and must be no
more than NGROUPS, as defined in 
.PN <sys/param.h> .
.PP
Only the superuser can set new groups.
.SH Return Values
A 0 value is returned on success, \-1 on an error, with
the error code stored in \fIerrno\fP.
.SH Diagnostics
The 
.PN setgroups
call fails if:
.TP 15
[EPERM]
The caller is not the superuser.
.TP 15
[EFAULT]
The address specified for 
.I gidset 
is outside the process
address space.
.SH See Also
getgroups(2), initgroups(3x)