getgroups(2)                  System Calls Manual                 getgroups(2)

NUME
       getgroups, setgroups - ob<?>ine/stabile<?>te o lista de ID-uri de
       grupuri suplimentare

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #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]);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       setgroups():
           Incepand cu glibc 2.19:
               _DEFAULT_SOURCE
           glibc 2.19 <?>i versiunile anterioare:
               _BSD_SOURCE

DESCRIERE
       getgroups() returneaza in list ID-urile de grup suplimentare ale
       procesului apelant. Argumentul size trebuie sa fie definit la numarul
       maxim de elemente care pot fi stocate in memoria tampon indicata de
       list. In cazul in care procesul de apelare este membru a mai mult de
       size grupuri suplimentare, apare o eroare.

       Nu este specificat daca ID-ul efectiv al grupului procesului apelant
       este inclus in lista returnata; (astfel, o aplica<?>ie trebuie sa
       apeleze <?>i getegid(2) <?>i sa adauge sau sa elimine valoarea
       rezultata).

       Daca size este zero, list nu este modificat, dar se returneaza numarul
       total de ID-uri de grup suplimentare pentru proces. Acest lucru permite
       apelantului sa determine dimensiunea unei liste list alocate dinamic,
       care va fi utilizata intr-un apel ulterior la getgroups().

       setgroups() stabile<?>te ID-urile de grup suplimentare pentru procesul
       apelant. Sunt necesare privilegii corespunzatoare (a se vedea
       descrierea erorii EPERM, mai jos). Argumentul size specifica numarul de
       ID-uri de grup suplimentare din memoria tampon indicata de list. Un
       proces poate renun<?>a la toate grupurile sale suplimentare odata cu
       apelul:

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

VALOAREA RETURNATA
       In caz de succes, getgroups() returneaza numarul de ID-uri de grup
       suplimentare. In caz de eroare, se returneaza -1, iar errno este
       configurata pentru a indica eroarea.

       In caz de succes, setgroups() returneaza 0. In caz de eroare, se
       returneaza -1, iar errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EFAULT list are o adresa nevalida.

       getgroups() poate e<?>ua in plus cu urmatoarea eroare:

       EINVAL size este mai mic decat numarul de ID-uri de grup suplimentare,
              dar nu este zero.

       setgroups() poate e<?>ua in plus cu urmatoarele erori:

       EINVAL size este mai mare decat NGROUPS_MAX (32 inainte de Linux 2.6.4;
              65536 incepand cu Linux 2.6.4).

       ENOMEM Memorie insuficienta.

       EPERM  Procesul apelant are privilegii insuficiente (apelantul nu are
              capacitatea CAP_SETGID in spa<?>iul de nume al utilizatorului in
              care se afla).

       EPERM (incepand cu Linux 3.19)
              Utilizarea setgroups() este interzisa in acest spa<?>iu de nume
              de utilizator. A se vedea descrierea /proc/pid/setgroups in
              user_namespaces(7).

VERSIUNI
   Diferen<?>e intre biblioteca C <?>i nucleu
       La nivelul nucleului, ID-urile de utilizator <?>i ID-urile de grup sunt
       un atribut pentru fiecare fir de execu<?>ie. Cu toate acestea, POSIX
       impune ca toate firele dintr-un proces sa aiba acelea<?>i
       creden<?>iale. Implementarea ,,NPTL threading" se ocupa de cerin<?>ele
       POSIX prin furnizarea de func<?>ii de invaluire pentru diferitele
       apeluri de sistem care modifica UID <?>i GID ale proceselor. Aceste
       func<?>ii invaluitoare (inclusiv cea pentru setgroups()) utilizeaza o
       tehnica bazata pe semnale pentru a se asigura ca, atunci cand un fir de
       execu<?>ie i<?>i schimba acreditarile, toate celelalte fire de
       execu<?>ie din proces i<?>i schimba <?>i ele acreditarile. Pentru
       detalii, a se vedea nptl(7).

STANDARDE
       getgroups()
              POSIX.1-2024.

       setgroups()
              Niciunul.

ISTORIC
       getgroups()
              4.3BSD, SVr4, POSIX.1-1988.

       setgroups()
              SVr4, 4.3BSD. Deoarece setgroups() necesita privilegii, nu este
              acoperit de POSIX.1.

       Apelul de sistem original Linux getgroups() accepta numai ID-uri de
       grup pe 16 bi<?>i. Ulterior, Linux 2.4 a adaugat getgroups32(), care
       accepta ID-uri pe 32 de bi<?>i. Func<?>ia invaluitoare glibc
       getgroups() trateaza in mod transparent varia<?>ia dintre versiunile de
       kernel.

NOTE
       Un proces poate avea pana la NGROUPS_MAX ID-uri de grup suplimentare in
       plus fa<?>a de ID-ul de grup efectiv. Constanta NGROUPS_MAX este
       definita in <limits.h>.  Setul de ID-uri de grup suplimentare este
       mo<?>tenit de la procesul parinte <?>i este pastrat prin intermediul
       unui execve(2).

       Numarul maxim de ID-uri de grup suplimentare poate fi aflat in timpul
       execu<?>iei folosind sysconf(3):

           long ngroups_max;
           ngroups_max = sysconf(_SC_NGROUPS_MAX);

       Valoarea maxima de returnare a lui getgroups() nu poate fi mai mare
       decat cu unu fa<?>a de aceasta valoare. Incepand cu Linux 2.6.4,
       numarul maxim de ID-uri de grup suplimentare este, de asemenea, expus
       prin intermediul fi<?>ierului de numai citire specific Linux,
       /proc/sys/kernel/ngroups_max.

EXEMPLE
       #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;
       }

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

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.18 8 februarie 2026                   getgroups(2)