osf1 man page for setgroups

setgroups(2)							System Calls Manual						      setgroups(2)

NAME
       setgroups - Sets the group access list

SYNOPSIS
       #include <unistd.h>
       #include <sys/types.h> int setgroups (
	       int gidsetsize,
	       gid_t grouplist[] );

PARAMETERS
       Indicates  the  number of entries in the array pointed to by the grouplist parameter.  Must not be more than NGROUPS_MAX, as defined in the
       limits.h header file.  Points to the array that contains the group access list of the current user process.  Element  grouplist[0]  becomes
       the new effective group ID.

DESCRIPTION
       The  setgroups() function sets the group access list of the current user process according to the array pointed to by the grouplist parame-
       ter.  This function fails unless the invoking process has superuser privilege.

NOTES
       Trial use

RETURN VALUES
       Upon successful completion, a value of 0 (zero) is returned.  If the setgroups() function fails, a value of -1 is returned and errno is set
       to indicate the error.

ERRORS
       If  the setgroups() function fails, errno may be set to one of the following values: The caller does not have the appropriate system privi-
       lege.  The value of the gidsetsize parameter is greater than NGROUPS_MAX or an entry in the grouplist parameter is not a  valid	group  ID.
       The grouplist parameter points outside of the allocated address space of the process.

RELATED INFORMATION
       Functions: getgroups(2), initgroups(3) delim off

																      setgroups(2)