getgroups(2) [bsd man page]

GETGROUPS(2)							System Calls Manual						      GETGROUPS(2)

NAME

       getgroups - get group access list

SYNOPSIS

       #include <sys/param.h>

       ngroups = getgroups(gidsetlen, gidset)
       int ngroups, gidsetlen, *gidset;

DESCRIPTION

       Getgroups  gets the current group access list of the user process and stores it in the array gidset.  The parameter gidsetlen indicates the
       number of entries that may be placed in gidset.	Getgroups returns the actual number of groups returned in gidset.  No more  than  NGROUPS,
       as defined in <sys/param.h>, will ever be returned.

RETURN VALUE

       A  successful  call  returns  the number of groups in the group set.  A value of -1 indicates that an error occurred, and the error code is
       stored in the global variable errno.

ERRORS

       The possible errors for getgroup are:

       [EINVAL]       The argument gidsetlen is smaller than the number of groups in the group set.

       [EFAULT]       The argument gidset specifies an invalid address.

SEE ALSO

       setgroups(2), initgroups(3X)

BUGS

       The gidset array should be of type gid_t, but remains integer for compatibility with earlier systems.

4.2 Berkeley Distribution					   May 13, 1986 						      GETGROUPS(2)

setgroups(2)							System Calls Manual						      setgroups(2)

NAME

       setgroups - set group access list

SYNOPSIS

DESCRIPTION

       sets  the  group  access  list  of  the	current user process according to the array gidset.  The parameter ngroups indicates the number of
       entries in the array and must be no more than

       Only a user with the privilege can set new groups by adding to the group access list of the current  user  process;  any  user  can  delete
       groups from it.

   Security Restrictions
       Some  or  all of the actions associated with this system call require the privilege.  Processes owned by the superuser have this privilege.
       Processes owned by other users may have this privilege, depending on system configuration.  See privileges(5) for  more	information  about
       privileged access on systems that support fine-grained privileges.

RETURN VALUE

       Upon successful completion, returns 0; otherwise it returns -1 and sets to indicate the error.

ERRORS

       fails if any of the following conditions are encountered:

	      The caller     is not a user with the privilege and has attempted to set new groups.

	      The address specified for
			     gidset is outside the process address space.  The reliable detection of this error is implementation dependent.

	      ngroups	     is greater than or not positive.

	      An entry in    gidset is not a valid group ID.

AUTHOR

       was developed by the University of California, Berkeley.

SEE ALSO

       getgroups(2), initgroups(3C), privileges(5).

STANDARDS CONFORMANCE

																      setgroups(2)