getpwnam - Benutzername ermitteln

Definition	#include <pwd.h> Optional #include <sys/types.h> (Ende) struct passwd *getpwnam(const char *name);
Beschreibung	getpwnam() durchsucht den Benutzerkatalog nach einem Eintrag, dessen Komponente pw_name mit name übereinstimmt (siehe auch pwd.h und Handbuch „POSIX-Grundlagen“ [1]). getpwnam() ist nicht threadsicher. Verwenden Sie bei Bedarf die reentrante Funktion getpwnam_r().
Returnwert	Zeiger auf eine Struktur vom Typ passwd (siehe pwd.h)
		bei Erfolg.
	Nullzeiger	wenn beim Lesen ein Fehler auftritt oder kein passender Eintrag gefunden wurde. errno wird gesetzt, um den Fehler anzuzeigen.
Fehler	getpwnam() schlägt fehl, wenn gilt:
	EINVAL	name ist zu lang.
	EFAULT	Fehler beim Anlegen der passwd-Struktur oder fehlerhafte Zeichenkette name.
	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 getpwnam() auf 0 gesetzt werden. Wenn der Fehler-Returnwert ungleich 0 ist, ist ein Fehler aufgetreten. 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	geteuid(), getlogin(), getpwnam_r(), getpwuid(), getuid(), limits.h, pwd.h, sys/types.h, Handbuch „POSIX-Grundlagen“ [1].