Provided by: manpages-de-dev_0.4-9_all bug

BEZEICHNUNG
       getgrent, setgrent, endgrent - hole Eintrag aus Gruppendatei


ÜBERSICHT
       #include <grp.h>
       #include <sys/types.h>

       struct group *getgrent(void);

       void setgrent(void);

       void endgrent(void);


BESCHREIBUNG
       Die Funktion getgrent() gibt einen Zeiger auf eine Struktur zurück, die
       die Gruppeninformationen aus /etc/group enthält.   Beim  ersten  Aufruf
       gibt  sie  den  ersten Eintrag zurück, danach bei jedem weiteren Aufruf
       die folgenden Einträge.

       Die Funktion setgrent() setzt den Dateizeiger auf den Anfang der  Datei
       /etc/group zurück.

       Die Funktion endgrent() schließt die Datei /etc/group.

       Die Struktur group ist in <grp.h> wie folgt definiert:

              struct group {
                      char    *gr_name;        /* Gruppenname */
                      char    *gr_passwd;      /* Gruppenpaßwort */
                      gid_t   gr_gid;          /* Gruppenkennung */
                      char    **gr_mem;        /* Gruppenmitglieder */
              };


RÜCKGABEWERT
       Die Funktion getgrent() gibt die Gruppeninformationstuktur zurück, oder
       NULL wenn  es  keine  weiteren  Einträge  mehr  gibt  oder  ein  Fehler
       auftritt.


FEHLER
       ENOMEM Zu wenig Speicher um die Gruppeninformationsstruktur zu belegen.


DATEIEN
       /etc/group Gruppendatenbankdatei


KONFORM ZU
       SVID 3, BSD 4.3


SIEHE AUCH
       fgetgrent(3), getgrnam(3), getgrgid(3).