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 muß das gleiche Format wie die Paß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).