getgrouplist(3)            Library Functions Manual            getgrouplist(3)

NUME
       getgrouplist - ob<?>ine lista de grupuri din care face parte un
       utilizator

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <grp.h>

       int getgrouplist(const char *user, gid_t group,
                        gid_t *groups, int *ngroups);

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

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

DESCRIERE
       Func<?>ia getgrouplist() analizeaza baza de date a grupurilor (a se
       vedea group(5)) pentru a ob<?>ine lista grupurilor din care face parte
       user. Pana la *ngroups din aceste grupuri sunt returnate in matricea
       groups.

       Daca nu se afla printre grupurile definite pentru user in baza de date
       a grupurilor, atunci group este inclus in lista de grupuri returnata de
       getgrouplist(); de obicei, acest argument este specificat ca fiind
       ID-ul grupului din inregistrarea parolei pentru user.

       Argumentul ngroups este un argument valoare-rezultat: la returnare
       con<?>ine intotdeauna numarul de grupuri gasite pentru user, inclusiv
       group; aceasta valoare poate fi mai mare decat numarul de grupuri
       stocate in groups.

VALOAREA RETURNATA
       Daca numarul de grupuri din care face parte user este mai mic sau egal
       cu *ngroups, atunci se returneaza valoarea *ngroups.

       Daca utilizatorul este membru a mai mult de *ngroups grupuri, atunci
       getgrouplist() returneaza -1. In acest caz, valoarea returnata in
       *ngroups poate fi utilizata pentru a redimensiona memoria tampon pasata
       la un apel ulterior la getgrouplist().

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |getgrouplist()                 | Siguran<?>a firelor | MT-Safe locale |
       +-------------------------------+---------------------+----------------+
STANDARDE
       Niciunul.

ISTORIC
       glibc 2.2.4.

ERORI
       Inainte de glibc 2.3.3, implementarea acestei func<?>ii con<?>ine o
       eroare de depa<?>ire a memoriei tampon: aceasta returneaza lista
       completa a grupurilor pentru utilizatorul user in matricea groups,
       chiar <?>i atunci cand numarul de grupuri depa<?>e<?>te *ngroups.

EXEMPLE
       Programul de mai jos afi<?>eaza lista de grupuri pentru utilizatorul
       men<?>ionat in primul sau argument de linie de comanda. Al doilea
       argument din linia de comanda specifica valoarea lui ngroups care
       trebuie furnizata lui getgrouplist(). Urmatoarea sesiune shell prezinta
       exemple de utilizare a acestui program:

           $ ./a.out cecilia 0
           getgrouplist() returned -1; ngroups = 3
           $ ./a.out cecilia 3
           ngroups = 3
           16 (dialout)
           33 (video)
           100 (users)

   Sursa programului
       #include <errno.h>
       #include <grp.h>
       #include <pwd.h>
       #include <stdio.h>
       #include <stdlib.h>

       int
       main(int argc, char *argv[])
       {
            int            ngroups;
           gid_t          *groups;
           struct group   *gr;
           struct passwd  *pw;

           if (argc != 3) {
               fprintf(stderr, "Utilizare: %s <user> <ngroups>\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           ngroups = atoi(argv[2]);

           groups = malloc(sizeof(*groups) * ngroups);
           if (groups == NULL) {
               perror("malloc");
               exit(EXIT_FAILURE);
           }

           /* Ob<?>ine structura passwd (con<?>ine primul ID de grup pentru utilizator). */

           errno = 0
           pw = getpwnam(argv[1]);
           if (pw == NULL) {
               if (errno)
                   perror("getpwnam");
               else
                   fprintf(stderr, "nu exista un astfel de utilizator\n");
               exit(EXIT_FAILURE);
           }

           /* Preluarea listei de grupuri. */

           if (getgrouplist(argv[1], pw->pw_gid, groups, &ngroups) == -1) {
               fprintf(stderr, "getgrouplist() returned -1; ngroups = %d\n",
                       ngroups);
               exit(EXIT_FAILURE);
           }

           /* Afi<?>eaza lista grupurilor recuperate, impreuna cu numele grupurilor. */

           fprintf(stderr, "ngroups = %d\n", ngroups);
           for (size_t j = 0; j < ngroups; j++) {
               printf("%d", groups[j]);
               gr = getgrgid(groups[j]);
               if (gr != NULL)
                   printf(" (%s)", gr->gr_name);
               printf("\n");
           }

           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       getgroups(2), setgroups(2), getgrent(3), group_member(3), group(5),
       passwd(5)

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.12   23 iulie 2024                 getgrouplist(3)