FGETPWENT(3)

BEZEICHNUNG
fgetpwent - arbeite mit Passworteintrag

Diese Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie die englischsprachige Handbuchseite zu Rate, indem Sie

    man -LC 3 fgetpwent

eingeben.

Ü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 muss das gleiche Format wie die Passwortdatei /etc/passwd haben. Die Struktur passwd ist in <pwd.h> wie folgt definiert:

    struct passwd {
            char    *pw_name;		/* Benutzername */
            char    *pw_passwd;		/* Passwort */
            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).