Linux Certif

Toute la documentation sur la certification Linux LPI

fgetpwent

BEZEICHNUNG

fgetpwent - arbeite mit Passworteintrag

Ü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).