getgrgid - Gruppendateieintrag für Gruppennummer ermitteln

Definition	#include <grp.h> Optional #include <sys/types.h> (Ende) struct group *getgrgid(gid_t gid);
Beschreibung	getgrgid() durchsucht die Gruppendatei nach einem Eintrag, dessen Komponente gr_gid mit gid übereinstimmt (siehe grp.h und Handbuch „POSIX-Grundlagen“ [1]). getgrgid() ist nicht threadsicher. Verwenden Sie bei Bedarf die reentrante Funktion getgrgid_r().
Returnwert	Zeiger auf ein Objekt der Struktur group
		wenn ein Eintrag gefunden wurde, dessen Komponente gr_gid mit gid übereinstimmt.
	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	getgrgid() schlägt fehl, wenn gilt:
	EIO	Ein Ein-/Ausgabefehler ist aufgetreten.
	EINTR	Während des Ablaufs von getgrgid() 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. Da getgrgid() Funktionen zur Dateiverarbeitung aufruft, die auf Fehler laufen können, sollte errno vor dem Aufruf von getgrgid() auf 0 gesetzt werden. Wenn errno nach Rückkehr der Funktion einen anderen Wert hat, dann ist ein Fehler aufgetreten.
Siehe auch	getgrgid_r(), getgrnam(), grp.h, limits.h, sys/types.h, Handbuch „POSIX-Grundlagen“ [1].