getgrent

GETGRENT(3)                  Bibliotheksfunktionen                 GETGRENT(3)



NAME
       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).



GNU                            31. Oktober 1996                    GETGRENT(3)