getgrgid_r(3)                                                 getgrgid_r(3)

NAME
     getgrgidr - Gruppendatenbank-Eintrag für eine Gruppen-ID thread-
     sicher abfragen

SYNTAX
     #include <grp.h>

     int getgrgidr(gidt gid, struct group *grp, char *buffer,
          sizet bufsize, struct group **result);

BESCHREIBUNG
     Die Funktion getgrgidr() aktualisiert die Gruppenstruktur, auf die
     grp zeigt, und speichert einen Zeiger auf diese Struktur an der
     Adresse, auf die result zeigt. Die Struktur enthält einen Eintrag aus
     der Gruppendatenbank mit einer entsprechenden Gruppen-ID gid. Spei-
     cher, auf den die Gruppenstruktur verweist, wird aus dem über den
     Parameter buffer zur Verfügung gestellten Speicher zugeordnet, der die
     Größe von bufsize Zeichen aufweist. Ein NULL-Zeiger wird an der
     Adresse zurückgegeben, auf die das Ergebnis zeigt, wenn ein Fehler
     auftritt oder der angeforderte Eintrag nicht gefunden wird.

     Anwendungen, bei denen eine Überprüfung auf Fehlersituatonen vorgese-
     hen ist, müssen errno auf 0 setzen, bevor getgrgidr() aufgerufen
     wird. Ist errno bei der Rückkehr auf einen Wert ungleich Null gesetzt,
     tritt ein Fehler auf.

RÜCKGABEWERTE
     Bei erfolgreicher Ausführung gibt die Funktion getgrgidr() den Wert
     Null zurück. Andernfalls wird eine Fehlernummer zurückgegeben, um den
     Fehler anzuzeigen.

FEHLER
     Die Funktion getgrgidr() kann bei folgender Bedingung fehlschlagen:

     ERANGE    Der über buffer und bufsize zur Verfügung gestellte Speicher
               reicht für die Aufnahme der Daten, auf die die resultierende
               Gruppenstruktur verweist, nicht aus.

SIEHE AUCH
     getgrgid(3C), grp(5).















Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98