getpwent_r(3)              Library Functions Manual              getpwent_r(3)

NUME
       getpwent_r, fgetpwent_r - ob<?>ine intrarea din fi<?>ierul passwd in
       mod reentrant

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <pwd.h>

       int getpwent_r(struct passwd *restrict pwbuf,
                      char buf[restrict .size], size_t size,
                      struct passwd **restrict pwbufp);
       int fgetpwent_r(FILE *restrict stream, struct passwd *restrict pwbuf,
                      char buf[restrict .size], size_t size,
                      struct passwd **restrict pwbufp);

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

       getpwent_r(),
           Incepand cu glibc 2.19:
               _DEFAULT_SOURCE
           glibc 2.19 <?>i versiunile anterioare:
               _BSD_SOURCE || _SVID_SOURCE

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

DESCRIERE
       Func<?>iile getpwent_r() <?>i fgetpwent_r() sunt versiunile reentrante
       ale getpwent(3) <?>i fgetpwent(3). Prima cite<?>te urmatoarea intrare
       passwd din fluxul ini<?>ializat de setpwent(3).  Cea de-a doua
       cite<?>te urmatoarea intrare passwd din stream.

       Structura passwd este definita in <pwd.h> dupa cum urmeaza:

           struct passwd {
               char    *pw_name;      /* nume utilizator */
               char    *pw_passwd;    /* parola utilizator */
               uid_t    pw_uid;       /* ID utilizator */
               gid_t    pw_gid;       /* ID grup */
               char    *pw_gecos;     /* informa<?>ii utilizator */
               char    *pw_dir;       /* directorul personal */
               char    *pw_shell;     /* program shell */
           };

       Pentru mai multe informa<?>ii despre campurile acestei structuri,
       consulta<?>i passwd(5).

       Func<?>iile nereentrante returneaza un indicator catre o memorie
       statica, unde aceasta memorie statica con<?>ine al<?>i indicatori
       pentru numele de utilizator, parola, campul gecos, directorul principal
       <?>i shell-ul.  Func<?>iile reentrante descrise aici returneaza toate
       acestea in memorii tampon furnizate de apelant. In primul rand, exista
       memoria tampon pwbuf care poate con<?>ine o struct passwd. <?>i apoi
       memoria tampon buf de dimensiune size care poate con<?>ine <?>iruri de
       caractere suplimentare. Rezultatul acestor func<?>ii, struct passwd
       citit din flux, este stocat in memoria tampon furnizata *pwbuf, iar un
       indicator la aceasta struct passwd este returnat in *pwbufp.

VALOAREA RETURNATA
       In caz de succes, aceste func<?>ii returneaza 0, iar *pwbufp este un
       indicator la struct passwd. In caz de eroare, aceste func<?>ii
       returneaza o valoare de eroare, iar *pwbufp 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                         |
       +--------------+---------------------+---------------------------------+
       |getpwent_r()  | Siguran<?>a firelor | MT-Unsafe race:pwent locale     |
       +--------------+---------------------+---------------------------------+
       |fgetpwent_r() | Siguran<?>a firelor | MT-Safe                         |
       +--------------+---------------------+---------------------------------+
       In tabelul de mai sus, pwent din race:pwent semnifica faptul ca, daca
       oricare dintre func<?>iile setpwent(), getpwent(), endpwent() sau
       getpwent_r() sunt utilizate in paralel in diferite fire de execu<?>ie
       ale unui program, atunci pot aparea competi<?>ii de date.

VERSIUNI
       Alte sisteme utilizeaza prototipul

           struct passwd *
           getpwent_r(struct passwd *pwd, char buf[.size], int size);

       sau, mai bine zis,

           int
           getpwent_r(struct passwd *pwd, char buf[.size], int size,
                      FILE **pw_fp);

STANDARDE
       Niciunul.

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

NOTE
       Func<?>ia getpwent_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 <pwd.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>

       #define BUFLEN 4096

       int
       main(void)
       {
           struct passwd pw;
           struct passwd *pwp;
           char buf[BUFLEN];
           int i;

           setpwent();
           while (1) {
               i = getpwent_r(&pw, buf, sizeof(buf), &pwp);
               if (i)
                   break;
               printf("%s (%jd)\tHOME %s\tSHELL %s\n", pwp->pw_name,
                      (intmax_t) pwp->pw_uid, pwp->pw_dir, pwp->pw_shell);
           }
           endpwent();
           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       fgetpwent(3), getpw(3), getpwent(3), getpwnam(3), getpwuid(3),
       putpwent(3), 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 24 decembrie 2024                 getpwent_r(3)