getpwuid - Benutzernummer ermitteln

Definition	#include <pwd.h> Optional #include <sys/types.h> (Ende) struct passwd *getpwuid(uid_t uid);
Beschreibung	getpwuid() durchsucht den Benutzerkatalog nach einem Eintrag, dessen Komponente pw_uid (siehe Struktur passwd in pwd.h) mit uid übereinstimmt. Nachfolgende Strukturen mit derselben Benutzernummer werden nicht gefunden.
Returnwert	Zeiger auf eine Struktur vom Typ passwd (siehe pwd.h)
		bei Erfolg.
	Nullzeiger	wenn beim Lesen ein Fehler auftritt oder im Benutzerkatalog keine zu uid passende Komponente pw_uid gefunden wurde.
Fehler	getpwuid() schlägt fehl, wenn gilt:
	EFAULT	Fehler beim Anlegen der passwd-Struktur.
	ENOENT	Benutzer ist unbekannt.
Hinweise	Der Returnwert kann auf einen statischen Bereich zeigen, der durch einen späteren cuserid-, getpwnam- oder getpwuid-Aufruf überschrieben werden kann. Wenn Fehlersituationen untersucht werden sollen, muss errno vor dem Aufruf von getpwuid() auf 0 gesetzt werden. Die drei Namen eines aktuellen Prozesses können wie folgt festgestellt werden: getpwuid(geteuid()) gibt u.a. den Namen zurück, der mit der effektiven Benutzernummer des Prozesses verbunden ist, getlogin() gibt die Benutzerkennung der aktuellen Login-Aktivität zurück, und getpwuid(getuid()) gibt u a. den Namen zurück, der mit der realen Benutzernummer des Prozesses verbunden ist.
Siehe auch	cuserid(), getpwuid_r(), getpwnam(), geteuid(), getuid(), getlogin(), limits.h, pwd.h , sys/types.h , Handbuch „POSIX-Grundlagen“ [1].