getgrent_r(3)              Library Functions Manual              getgrent_r(3)

NUME
       getgrent_r, fgetgrent_r - ob<?>ine intrarea fi<?>ierului de grup in mod
       reentrant

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <grp.h>

       int getgrent_r(size_t size;
                      struct group *restrict gbuf,
                      char buf[restrict size], size_t size,
                      struct group **restrict gbufp);
       int fgetgrent_r(size_t size;
                      FILE *restrict stream, struct group *restrict gbuf,
                      char buf[restrict size], size_t size,
                      struct group **restrict gbufp);

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

       getgrent_r():
           _GNU_SOURCE

       fgetgrent_r():
           Incepand cu glibc 2.19:
               _DEFAULT_SOURCE
           glibc 2.19 <?>i versiunile anterioare:
               _SVID_SOURCE

DESCRIERE
       Func<?>iile getgrent_r() <?>i fgetgrent_r() sunt versiunile reentrante
       ale func<?>iilor getgrent(3) <?>i fgetgrent(3). Prima cite<?>te
       urmatoarea intrare de grup din fluxul ini<?>ializat de setgrent(3). Cea
       de-a doua cite<?>te urmatoarea intrare de grup din stream.

       Structura group este definita in <grp.h> dupa cum urmeaza:

           struct group {
               char   *gr_name;        /* numele grupului */
               char   *gr_passwd;      /* parola grupului */
               gid_t   gr_gid;         /* identificatorul grupului */
               char  **gr_mem;         /* vector de indicatori cu termina<?>ie NULL
                                          la numele membrilor grupului */
           };

       Pentru mai multe informa<?>ii despre campurile acestei structuri, a se
       vedea group(5).

       Func<?>iile care nu sunt reentrante returneaza un indicator catre
       stocarea statica, unde aceasta stocare statica con<?>ine al<?>i
       indicatori catre numele grupului, parola <?>i membrii. Func<?>iile
       reentrante descrise aici returneaza toate acestea in memoriile tampon
       furnizate de apelant. In primul rand, exista o memorie tampon gbuf care
       poate con<?>ine o structura de grup. <?>i apoi tamponul buf de
       dimensiune size care poate con<?>ine <?>iruri de caractere
       suplimentare. Rezultatul acestor func<?>ii, structura de grup citita
       din flux, este stocata in memoria tampon furnizata *gbuf, iar un
       indicator la aceasta structura de grup este returnat in *gbufp.

VALOAREA RETURNATA
       In caz de succes, aceste func<?>ii returneaza 0, iar *gbufp este un
       indicator la structura de grup. In caz de eroare, aceste func<?>ii
       returneaza o valoare de eroare, iar *gbufp este NULL.

ERORI-IE<?>IRE
       ENOENT Nu mai exista alte intrari.

       ERANGE Spa<?>iu de memorie tampon furnizat insuficient. Incerca<?>i din
              nou cu o memorie tampon mai mare.

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

       +--------------+---------------------+---------------------------------+
       |Interfa<?>a   | Atribut             | Valoare                         |
       +--------------+---------------------+---------------------------------+
       |getgrent_r()  | Siguran<?>a firelor | MT-Unsafe race:grent locale     |
       +--------------+---------------------+---------------------------------+
       |fgetgrent_r() | Siguran<?>a firelor | MT-Safe                         |
       +--------------+---------------------+---------------------------------+
       In tabelul de mai sus, grent din race:grent semnifica faptul ca, daca
       oricare dintre func<?>iile setgrent(3), getgrent(3), endgrent(3) sau
       getgrent_r() sunt utilizate in paralel in diferite fire de execu<?>ie
       ale unui program, pot aparea competi<?>ii de date.

VERSIUNI
       Alte sisteme utilizeaza prototipul

           struct group *getgrent_r(struct group *grp, char buf[.size],
                                    int size);

       sau, mai bine zis,

           int getgrent_r(struct group *grp, char buf[.size], int size,
                          FILE **gr_fp);

STANDARDE
       GNU.

ISTORIC
       Aceste func<?>ii sunt realizate intr-un stil asemanator cu versiunea
       POSIX a unor func<?>ii precum getpwnam_r(3).

NOTE
       Func<?>ia getgrent_r() nu este cu adevarat reentranta, deoarece imparte
       pozi<?>ia de citire in flux cu toate celelalte fire de execu<?>ie.

EXEMPLE
       #define _GNU_SOURCE
       #include <grp.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #define BUFLEN 4096

       int
       main(void)
       {
           struct group grp;
           struct group *grpp;
           char buf[BUFLEN];
           int i;

           setgrent();
           while (1) {
               i = getgrent_r(&grp, buf, sizeof(buf), &grpp);
               if (i)
                   break;
               printf("%s (%jd):", grpp->gr_name, (intmax_t) grpp->gr_gid);
               for (size_t j = 0; ; j++) {
                   if (grpp->gr_mem[j] == NULL)
                       break;
                   printf(" %s", grpp->gr_mem[j]);
               }
               printf("\n");
           }
           endgrent();
           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       fgetgrent(3), getgrent(3), getgrgid(3), getgrnam(3), putgrent(3),
       group(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.15   28 iunie 2025                   getgrent_r(3)