getgroups

###

###

###

###

###

###

###

###

###

###

    GETGROUPS(2)        Linux Programmer's Manual        GETGROUPS(2)

    NAME
           getgroups, setgroups - get/set group access list

    SYNOPSIS
           #include <unistd.h>

           int getgroups(int size, gid_t list[]);

           #define __USE_BSD
           #include <grp.h>

           int setgroups(size_t size, const gid_t *list);

    DESCRIPTION
           getgroups
                  Up  to  size  supplemental  groups  are returned in
                  list.  If size is zero, list is not  modified,  but
                  the  total  number  of  supplemental groups for the
                  process is returned.

           setgroups
                  Sets the supplemental groups for the process.  Only
                  the super-user may use this function.

    RETURN VALUE
           getgroups
                  On  success, the number of groups stored in list is
                  returned (if size is zero, however, the  number  of
                  supplemental  group IDs associated with the process
                  is returned).  On error, -1 is returned, and  errno
                  is set appropriately.

           setgroups
                  On  success,  zero  is  returned.   On error, -1 is
                  returned, and errno is set appropriately.

    ERRORS
           EFAULT list has an invalid address.

           EPERM  For setgroups, the user is not the super-user.

           EINVAL For setgroups, gidsetsize is greater  than  NGROUPS
                  (32 for Linux 0.99.11).

    CONFORMING TO
           getgroups conforms to POSIX.1 (and is present in BSD 4.3).
           Since setgroups requires  privilege,  it  is  not  covered
           under POSIX.1.

    BUGS
           The __USE_BSD flag probably shouldn't be required for set-
           groups.

    Linux 0.99.11              23 July 1993                         1

    GETGROUPS(2)        Linux Programmer's Manual        GETGROUPS(2)

### SEE ALSO

initgroups,

###

    Linux 0.99.11              23 July 1993                         2

Top | Master Index | Keywords | Functions

This manual page was brought to you by mjl_man V-2.0