BEZEICHNUNG
fgetpwent - Eintrag aus Passwortdatei auslesen
ÜBERSICHT
#include
<stdio.h>
#include <sys/types.h>
#include <pwd.h>
struct passwd *fgetpwent(FILE *stream);
Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):
fgetpwent():
Seit Glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 und älter:
_SVID_SOURCE
BESCHREIBUNG
Die Funktion fgetpwent() gibt einen Zeiger auf eine Struktur zurück, die die aufgeteilten Felder einer Zeile der Datei stream enthält. Beim ersten Aufruf wird der erste Eintrag zurückgegeben; danach werden die nachfolgenden Einträge zurückgegeben. Die Datei, auf die stream verweist, muss das gleiche Format wie die Passwortdatei /etc/passwd haben (siehe passwd(5)).
Die Struktur passwd ist in <pwd.h> wie folgt definiert:
struct passwd {
char *pw_name; /* Benutzername */
char *pw_passwd; /* Benutzerpasswort */
uid_t pw_uid; /* Benutzerkennung */
gid_t pw_gid; /* Gruppenkennung */
char *pw_gecos; /* Echter Name */
char *pw_dir; /* Home-Verzeichnis */
char *pw_shell; /* Shellprogram */
};
RÜCKGABEWERT
Die Funktion fgetpwent() gibt entweder einen Zeiger auf eine passwd-Struktur zurück oder NULL, wenn keine weiteren Einträge vorhanden sind oder ein Fehler aufgetreten ist. Im Fehlerfall wird errno gesetzt, um die Ursache des Fehlers anzuzeigen.
FEHLER
|
ENOMEM |
Der Speicher reicht nicht aus, um ihn für die Struktur passwd zu reservieren. |
DATEIEN
/etc/passwd
Passwortdatenbank
ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
KONFORM ZU
SVr4.
SIEHE AUCH
endpwent(3), fgetpwent_r(3), fopen(3), getpw(3), getpwent(3), getpwnam(3), getpwuid(3), putpwent(3), setpwent(3), passwd(5)
KOLOPHON
Diese Seite ist Teil der Veröffentlichung 5.07 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey [AT] infodrom.org> und Dr. Tobias Quathamer <toddy [AT] debian.org> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german [AT] lists.org>.