getpwent(3)                Library Functions Manual                getpwent(3)

NUME
       getpwent, setpwent, endpwent - ob<?>ine intrarea din fi<?>ierul de
       parole

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <sys/types.h>
       #include <pwd.h>

       struct passwd *getpwent(void);
       void setpwent(void);
       void endpwent(void);

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

       getpwent(), setpwent(), endpwent():
           _XOPEN_SOURCE >= 500
               || /* glibc >= 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIERE
       Func<?>ia getpwent() returneaza un indicator catre o structura care
       con<?>ine campurile defalcate ale unei inregistrari din baza de date de
       parole (de exemplu, fi<?>ierul local de parole /etc/passwd, NIS <?>i
       LDAP). Prima data cand este apelata getpwent(), aceasta returneaza
       prima intrare; ulterior, returneaza intrari succesive.

       Func<?>ia setpwent() revine la inceputul bazei de date cu parole.

       Func<?>ia endpwent() este utilizata pentru a inchide baza de date cu
       parole dupa ce a fost efectuata intreaga procesare.

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

           struct passwd {
               char   *pw_name;       /* numele utilizatorului */
               char   *pw_passwd;     /* parola utilizatorului */
               uid_t   pw_uid;        /* identificatorul utilizatorului */
               gid_t   pw_gid;        /* identificatorul grupului */
               char   *pw_gecos;      /* informa<?>ii despre utilizator */
               char   *pw_dir;        /* directorul personal ,,acasa" */
               char   *pw_shell;      /* programul shell */
           };

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

VALOAREA RETURNATA
       Func<?>ia getpwent() returneaza un indicator catre o structura passwd
       sau NULL daca nu mai exista intrari sau daca s-a produs o eroare. In
       cazul in care apare o eroare, errno este configurata pentru a indica
       eroarea. Daca se dore<?>te verificarea lui errno dupa apel, aceasta
       trebuie sa fie stabilita la zero inainte de apel.

       Valoarea de returnare poate indica o zona statica <?>i poate fi
       suprascrisa de apelurile ulterioare la getpwent(), getpwnam(3) sau
       getpwuid(3); (nu pasa<?>i indicatorul returnat la free(3)).

ERORI-IE<?>IRE
       EINTR  A fost captat un semnal; a se vedea signal(7).

       EIO    Eroare de In/Ie<?>.

       EMFILE Limita per proces a numarului de descriptori de fi<?>iere
              deschise a fost atinsa.

       ENFILE Limita la nivel de sistem a numarului total de fi<?>iere
              deschise a fost atinsa.

       ENOMEM Memorie insuficienta pentru alocarea structurii passwd.

       ERANGE Spa<?>iul de memorie tampon furnizat este insuficient.

FI<?>IERE
       /etc/passwd
              fi<?>ierul local al bazei de date de parole

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

       +------------+---------------------+-----------------------------------+
       |Interfa<?>a | Atribut             | Valoare                           |
       +------------+---------------------+-----------------------------------+
       |getpwent()  | Siguran<?>a firelor | MT-Unsafe race:pwent              |
       |            |                     | race:pwentbuf locale              |
       +------------+---------------------+-----------------------------------+
       |setpwent(), | Siguran<?>a firelor | MT-Unsafe race:pwent locale       |
       |endpwent()  |                     |                                   |
       +------------+---------------------+-----------------------------------+
       In tabelul de mai sus, pwent din race:pwent semnifica faptul ca, daca
       oricare dintre func<?>iile setpwent(), getpwent() sau endpwent() sunt
       utilizate in paralel in diferite fire de execu<?>ie ale unui program,
       pot aparea situa<?>ii de competi<?>ie de date.

VERSIUNI
       Campul pw_gecos nu este specificat in POSIX, dar este prezent in
       majoritatea implementarilor.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, SVr4, 4.3BSD.

CONSULTA<?>I <?>I
       fgetpwent(3), getpw(3), getpwent_r(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   23 iulie 2024                     getpwent(3)