getgroups(2)                  System Calls Manual                 getgroups(2)

<?><?><?><?><?>
       getgroups, setgroups - <?><?><?><?><?><?>/<?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>

<?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> (libc<?> -lc)

<?><?><?><?>
       #include <unistd.h>

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

       #include <grp.h>

       int setgroups(size_t size, const gid_t list[size]);

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
   <?><?><?><?><?><?><?> <?><?> glibc (<?><?><?><?> feature_test_macros(7)):

       setgroups():
           <?><?><?> glibc 2.19:
               _DEFAULT_SOURCE
           glibc 2.19 <?><?><?> <?><?><?><?>:
               _BSD_SOURCE

<?><?><?><?><?>
       <?><?><?><?> getgroups()  <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> list.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> size <?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       list.  <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       size <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?>.

       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
       (<?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> getegid(2) <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.)

       <?><?><?> <?><?><?> size <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> list<?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> list <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> getgroups().

       <?><?><?><?> setgroups()  <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?><?><?> <?><?><?> <?><?><?> EPERM
       <?><?><?><?><?>).  <?><?><?><?> <?><?><?><?><?><?><?> size <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       list.  <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>:

           setgroups(0, (gid_t [0]){});

<?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> getgroups()  <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> -1<?> <?><?><?><?> <?><?><?><?><?> errno
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> setgroups()  0.  <?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> -1<?> <?><?><?><?>
       <?><?><?><?><?> errno <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?><?>
       EFAULT list <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?> <?><?><?><?> getgroups()  <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

       EINVAL size <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       <?><?><?><?> <?><?> <?><?><?><?> setgroups()  <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

       EINVAL size <?><?><?><?> <?><?> NGROUPS_MAX (32 <?><?><?> Linux
              2.6.4<?> 65536 <?><?><?> Linux 2.6.4).

       ENOMEM <?><?><?><?> <?><?><?><?><?><?><?>.

       EPERM  <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              (<?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              CAP_SETGID <?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?>).

       EPERM (<?><?><?> Linux 3.19)
              <?><?><?><?><?><?><?> setgroups()  <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?> /proc/pid/setgroups <?><?>
              user_namespaces(7).

<?><?><?><?><?><?><?><?><?>
   <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> C
       <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?><?>
       POSIX <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> NPTL <?><?><?><?><?><?><?> POSIX <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> UIDs <?> GIDs
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> (<?><?><?> <?><?> <?><?><?> <?><?><?><?>
       setgroups())  <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       nptl(7).

<?><?><?><?><?><?><?><?>
       getgroups()
              POSIX.1-2024.

       setgroups()
              <?><?> <?><?><?>.

<?><?><?><?><?><?><?>
       getgroups()
              4.3BSD<?> SVr4<?> POSIX.1-1988.

       setgroups()
              SVr4, 4.3BSD.  <?><?><?><?><?> <?><?><?> setgroups()
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?> POSIX.1.

       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> Linux
       getgroups()  <?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> 16 <?><?>.  <?><?><?><?><?><?><?> <?><?><?><?>
       Linux 2.4 getgroups32()<?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       32 <?><?>.  <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> glibc
       getgroups()  <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?> <?><?><?> NGROUPS_MAX <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?><?>
       NGROUPS_MAX <?><?><?><?> <?><?> <limits.h>.  <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       execve(2).

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> sysconf(3):

           long ngroups_max;
           ngroups_max = sysconf(_SC_NGROUPS_MAX);

       <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> getgroups()
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> Linux 2.6.4<?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> Linux<?> /proc/sys/kernel/ngroups_max.

<?><?><?><?><?>
       #include <err.h>
       #include <stddef.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <sys/types.h>
       #include <unistd.h>

       #define MALLOC(n, T)  ((T *) reallocarray(NULL, n, sizeof(T)))

       static gid_t *agetgroups(size_t *ngids);

       int
       main(void)
       {
           gid_t   *gids;
           size_t  n;

           gids = agetgroups(&n);
           if (gids == NULL)
               err(EXIT_FAILURE, "agetgroups");

           if (n != 0) {
               printf("%jd", (intmax_t) gids[0]);
               for (size_t i = 1; i < n; i++)
                   printf(" %jd", (intmax_t) gids[i]);
           }
           puts("");

           free(gids);
           exit(EXIT_SUCCESS);
       }

       static gid_t *
       agetgroups(size_t *ngids)
       {
           int    n;
           gid_t  *gids;

           n = getgroups(0, NULL);
           if (n == -1)
               return NULL;

           gids = MALLOC(n, gid_t);
           if (gids == NULL)
               return NULL;

           n = getgroups(n, gids);
           if (n == -1) {
               free(gids);
               return NULL;
           }

           *ngids = n;
           return gids;
       }

<?><?><?><?> <?><?><?><?><?>
       getgid(2), setgid(2), getgrouplist(3), group_member(3), initgroups(3),
       capabilities(7), credentials(7)

<?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <zayed.alsaidi@gmail.com>

       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> 3
       <https://www.gnu.org/licenses/gpl-3.0.html> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>:
       <kde-l10n-ar@kde.org>.


<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> 6.18
                           8 <?><?><?><?><?><?> 2026              getgroups(2)