setgroups(2) - NetBSD Manual Pages

SETGROUPS(2)              NetBSD System Calls Manual              SETGROUPS(2)


NAME
setgroups -- set group access list
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/param.h> #include <unistd.h> int setgroups(int ngroups, const gid_t *gidset);
DESCRIPTION
setgroups() sets the group access list of the current user process according to the array gidset. The parameter ngroups indicates the num- ber of entries in the array and must be no more than {NGROUPS_MAX}. Only the super-user may set new groups. This system call affects only secondary groups.
RETURN VALUES
A 0 value is returned on success, -1 on error, with an error code stored in errno.
ERRORS
The setgroups() call will fail if: [EINVAL] The value of ngroups is greater than {NGROUPS_MAX}. [EPERM] The caller is not the super-user. [EFAULT] The address specified for gidset is outside the process address space.
SEE ALSO
getgroups(2), setegid(2), setgid(2), setregid(2), initgroups(3)
HISTORY
The setgroups() function call appeared in 4.2BSD. NetBSD 9.4_STABLE October 7, 2006 NetBSD 9.4_STABLE

Powered by man-cgi (2024-08-26). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.