Provided by:
manpages-de-dev_0.10-1_all 
BEZEICHNUNG
getpwent, setpwent, endpwent - Eintrag in Passwortdatei abfragen
"UBERSICHT
#include <sys/types.h>
#include <pwd.h>
struct passwd *getpwent(void);
void setpwent(void);
void endpwent(void);
Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):
getpwent(), setpwent(), endpwent():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
BESCHREIBUNG
Die Funktion getpwent() gibt einen Zeiger auf eine Struktur zuruck, die
aus einem Datensatz herausgeloste Felder aus der Passwort-Datenbank
enthalt (z.B. die lokale Passwortdatei, NIS und LDAP). Wenn getpwent()
zum ersten Mal aufgerufen wird, gibt es den ersten Eintrag zuruck;
danach gibt es die Eintrage fortlaufend zuruck.
Die Funktion setpwent() setzt den Dateizeiger auf den Anfang der
Passwort-Datenbank.
Die Funktion endpwent() wird benutzt, um die Passwort-Datenbank zu
schlieBen, nachdem die Verarbeitung durchgefuhrt wurde.
Die Struktur passwd ist in <pwd.h> wie folgt definiert:
struct passwd {
char *pw_name; /* Benutzername */
char *pw_passwd; /* Passwort des Benutzers */
uid_t pw_uid; /* Benutzer-ID */
gid_t pw_gid; /* Gruppen-ID */
char *pw_gecos; /* Benutzerinformationen */
char *pw_dir; /* Home-Verzeichnis */
char *pw_shell; /* Anmelde-Shell */
};
Wenn shadow(5)-Passworter eingeschaltet sind (was auf vielen
GNU/Linux-Installationen Standard ist), ist der Inhalt von pw_passwd
normalerweise nicht sehr nutzlich. In einem solchen Fall sind die
meisten Passworter in einer separaten Datei gespeichert.
Die Variable pw_shell kann leer sein. In diesem Fall wird das System
die Standard-Shell (/bin/sh) fur den Benutzer ausfuhren.
Weitere Informationen uber die Felder dieser Struktur finden Sie unter
passwd(5).
R"UCKGABEWERT
Die Funktion getpwent() gibt einen Zeiger auf eine Passwort-Struktur
zuruck oder NULL, falls dort mehrere Eintrage sind oder ein Fehler
auftritt. Wenn ein Fehler auftritt, wird errno entsprechend gesetzt.
Falls errno nach dem Aufruf gepruft werden soll, sollte es vor dem
Aufruf auf Null gesetzt werden.
Der Ruckgabewert konnte auf einen statischen Bereich zeigen und von
nachfolgenden Aufrufen von getpwent(), getpwnam(3) oder getpwuid(3)
uberschrieben werden. (Ubergeben Sie den zuruckgegebenen Zeiger nicht
an free(3).)
FEHLER
EINTR Es wurde ein Signal abgefangen.
EIO E/A-Fehler
EMFILE Im aufrufenden Prozess wurde bereits die maximale Anzahl
(OPEN_MAX) von Dateien geoffnet.
ENFILE Im System wurde bereits die maximale Anzahl von Dateien
geoffnet.
ENOMEM Der Speicher reicht nicht aus, um ihn fur die Struktur passwd zu
reservieren.
ERANGE Der fur den Puffer bereitgestellte Platz reicht nicht aus.
DATEIEN
/etc/passwd
lokale Passwortdatenbank
KONFORM ZU
SVr4, 4.3BSD, POSIX.1-2001. Das Feld pw_gecos ist in POSIX nicht
spezifiziert, aber in den meisten Implementierungen vorhanden.
SIEHE AUCH
fgetpwent(3), getpw(3), getpwent_r(3), getpwnam(3), getpwuid(3),
putpwent(3), shadow(5), passwd(5)
KOLOPHON
Diese Seite ist Teil der Veroffentlichung 3.32 des Projekts
Linux-man-pages. Eine Beschreibung des Projekts und Informationen, wie
Fehler gemeldet werden konnen, finden sich unter
http://www.kernel.org/doc/man-pages/.
"UBERSETZUNG
Die deutsche Ubersetzung dieser Handbuchseite wurde von Martin Schulze
<joey@infodrom.org> und Chris Leick <c.leick@vollbio.de> erstellt.
Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
Public License Version 3 oder neuer bezuglich der Copyright-
Bedingungen. Es wird KEINE HAFTUNG ubernommen.
Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an <debian-l10n-
german@lists.debian.org>.