fgetpwent

FGETPWENT(3)                 Bibliotheksfunktionen                FGETPWENT(3)



BEZEICHNUNG
       fgetpwent - arbeite mit PaÃworteintrag

ÃBERSICHT
       #include <pwd.h>
       #include <stdio.h>
       #include <sys/types.h>

       struct passwd *fgetpwent(FILE *stream);

BESCHREIBUNG
       Die Funktion fgetpwent() gibt einen Zeiger auf eine Struktur zurück,
       die den Inhalt einer Zeile der Datei stream repräsentiert.  Beim
       ersten Aufruf wird der erste Eintrag zurückgegeben, bei weiteren die
       nachfolgenden.  Die Datei stream mus^ das gleiche Format wie die
       Pas^wortdatei /etc/passwd haben.

       Die Struktur passwd ist in <pwd.h> wie folgt definiert:

              struct passwd {
                      char    *pw_name;       /* Benutzername */
                      char    *pw_passwd;     /* PaÃwort */
                      uid_t   pw_uid;         /* User ID */
                      gid_t   pw_gid;         /* Group ID */
                      char    *pw_gecos;      /* Name bzw. GECOS */
                      char    *pw_dir;        /* Home-Verzeichnis */
                      char    *pw_shell;      /* Loginshell */
              };

RÃCKGABEWERT
       Die Funktion fgetpwent() gibt die passwd-struktur zurück oder NULL,
       wenn keine weiteren Einträge vorhanden sind.

FEHLER
       ENOMEM Es ist nicht ausreichend Speicher vorhanden, um Speicher für
              eine passwd-Struktur zu alloziieren.

KONFORM ZU
       SVID 3

SIEHE AUCH
       getpwnam(3), getpwuid(3), getpwent(3), setpwent(3), endpwent(3),
       getpw(3), putpwent(3), passwd(5).



GNU                              27. Mai 1996                     FGETPWENT(3)