table of contents
GETPW(3) | Linux-Programmierhandbuch | GETPW(3) |
BEZEICHNUNG¶
getpw - den Eintrag einer Passwortzeile rekonstruierenÜBERSICHT¶
#define _GNU_SOURCE /* siehe feature_test_macros(7) */ #include <sys/types.h> #include <pwd.h>int getpw(uid_t uid, char *puffer);
BESCHREIBUNG¶
Die Funktion getpw() rekonstruiert eine Zeile in der Passwortdatei im Puffer puffer für die angegebene Benutzer-ID uid. Der zurückgegebene Puffer enthält eine Zeile im folgenden Format:name:passwd:uid:gid:gecos:dir:shell
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 */ };
Weitere Informationen über die Felder dieser Struktur finden Sie unter passwd(5).
RÜCKGABEWERT¶
Die Funktion getpw() gibt bei Erfolg 0 zurück. Bei einem Fehler wird -1 zurückgegeben und errno so gesetzt, dass es den Fehler anzeigt.FEHLER¶
- EINVAL
- puffer ist NULL.
- ENOENT
- Zu uid gibt es keinen dazugehörigen Benutzer.
- ENOMEM
- Der Speicher reicht nicht aus, um ihn für die Struktur passwd zu reservieren.
DATEIEN¶
- /etc/passwd
- Passwortdatenbank
KONFORM ZU¶
SVr2.FEHLER¶
Die Funktion getpw() ist gefährlich, da sie den bereitgestellten Puffer puffer zum Überlauf bringen kann. Sie wurde durch getpwuid(3) ersetzt.SIEHE AUCH¶
endpwent(3), fgetpwent(3), getpwent(3), getpwnam(3), getpwuid(3), putpwent(3), setpwent(3), passwd(5)KOLOPHON¶
Diese Seite ist Teil der Veröffentlichung 3.42 des Projekts Linux- man-pages. Eine Beschreibung des Projekts und Informationen, wie Fehler gemeldet werden können, finden sich unter http://www.kernel.org/doc/man-pages/.ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey@infodrom.org> und Chris Leick <c.leick@vollbio.de> erstellt.21. Oktober 2010 | GNU |