getgrnam - Gruppendateieintrag für Gruppenname ermitteln

Definition	#include <grp.h> Optional #include <sys/types.h> (Ende) struct group *getgrnam(const char *name);
Beschreibung	Die Funktion getgrnam() durchsucht die Gruppendatei nach einem Eintrag, dessen Komponente gr_name mit name übereinstimmt (siehe auch grp.h und Handbuch „POSIX-Grundlagen“ [1]). getgrnam() ist nicht threadsicher. Verwenden Sie bei Bedarf die reentrante Funktion getgrnam_r().
Returnwert	Zeiger auf ein Objekt der Struktur group (siehe grp.h)
		bei Erfolg.
	Nullzeiger	wenn ein Fehler auftritt oder kein Eintrag gefunden wurde, dessen Komponente gr_gid mit gid übereinstimmt. errno wird gesetzt, um den Fehler anzuzeigen.
Fehler	Die Funktion getgrnam() schlägt fehl, wenn gilt:
	EIO	Ein Ein-/Ausgabefehler ist aufgetreten.
	EINTR	Während des Ablaufs der Funktion getgrnam() wurde ein Signal abgefangen.
	EMFILE	Für den aktuellen Prozess sind derzeit zu viele Dateideskriptoren offen.
	ENFILE	Die Dateitabelle des Systems ist derzeit voll.
Hinweise	Der Returnwert kann auf einen statischen Bereich zeigen, der durch einen späteren getgrid- oder getgrnam-Aufruf überschrieben werden kann. Wenn Fehlersituationen untersucht werden sollen, muss errno vor dem Aufruf von getgrnam() auf 0 gesetzt werden.
Siehe auch	getgrnam_r(), getgrgid(), grp.h, limits.h, sys/types.h, Handbuch „POSIX-Grundlagen“ [ 1 ].