Linux Certif

Toute la documentation sur la certification Linux LPI

getpwent

NAZWA

getpwent, setpwent, endpwent - pobranie wpisu z pliku z has³em

SK£ADNIA

#include <pwd.h>

#include <sys/types.h>



struct passwd *getpwent(void);



void setpwent(void);



void endpwent(void);

OPIS

Funkcja getpwend zwraca wska¼nik do struktury, zawieraj±cej poszczególne pola linijki z /etc/passwd. Podczas pierwszego wywo³ania, zwracany jest pierwszy wpis; pó¼niej zwracane s± kolejne.

Funkcja setpwent ustawia wska¼nik pliku na jego pocz±tek /etc/passwd.

Funkcja endpwent() zamyka plik /etc/passwd.

Struktura passwd jest zdefiniowana w <pwd.h> nastêpuj±co:

struct passwd {

        char    *pw_name;       /* nazwa u¿ytkownika */

        char    *pw_passwd;     /* has³o u¿ytkownika */

        uid_t   pw_uid;         /* identyfikator u¿ytkownika */

        gid_t   pw_gid;         /* identyfikator grupy */

        char    *pw_gecos;      /* imiê i nazwisko */

        char    *pw_dir;        /* katalog domowy */

        char    *pw_shell;      /* program pow³oki */

};

WARTO¦Æ ZWRACANA

Funkcja getpwent() zwraca wska¼nik do struktury passwd lub NULL, gdy nie ma wiêcej wpisów lub wyst±pi b³±d.

B£ÊDY

ENOMEM

Brak pamiêci do zaalokowania struktury passwd.

PLIKI

/etc/passwd

plik bazy z has³ami.

ZGODNE Z

SVID 3, BSD 4.3

ZOBACZ TAK¯E

fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd(5)