NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO
#include <unistd.h>int getgroups(int gidsetsize, gid_t * grouplist);
The getgroups() function gets the current supplemental group access list of the calling process and stores the result in the array of group ID s specified by grouplist . This array has gidsetsize entries and must be large enough to contain the entire list. This list cannot be larger than NGROUPS_MAX . If gidsetsize equals 0, getgroups() will return the number of groups to which the calling process belongs without modifying the array pointed to by grouplist .
The
setgroups()
function sets the supplementary group access list of the calling process from the array of group
ID
s specified by
grouplist
. The number of entries is specified by
ngroups
and can not be greater than
NGROUPS_MAX
. The calling process must have
PRIV_PROC_SETID
in its set of effective privileges to set new groups. If
PRIV_PROC_SETID
is not in the effective privilege set, the operation
fails and sets
errno
to
EPERM
.
Upon successful completion, getgroups() returns the number of supplementary group ID s set for the calling process and setgroups() returns 0 . Otherwise, -1 is returned and errno is set to indicate the error.
The getgroups() and setgroups() functions will fail if:
A referenced part of the array pointed to by grouplist is an illegal address.
The getgroups() function will fail if:
The value of gidsetsize is non-zero and less than the number of supplementary group ID s set for the calling process.
The setgroups() function will fail if:
The value of ngroups is greater than NGROUPS_MAX .
The calling process does not have the
PRIV_PROC_SETID
privilege.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT-Level | Async-Signal-Safe |
To set new groups, the calling process must have
PRIV_PROC_SETID
in its set of effective privileges.
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO