getgrent

Autres langues

Langue: de

Version: 31. Oktober 1996 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

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;      /* Gruppenpasswort */

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