GETGRNAM(3)

BEZEICHNUNG
getgrnam, getgrgid - liest den Usergruppendateieintrag

Diese Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie die englischsprachige Handbuchseite zu Rate, indem Sie

    man -LC 3 getgrnam

eingeben.

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

struct group *getgrnam(const char *name);

struct group *getgrgid(gid_t gid);

BESCHREIBUNG
Die getgrnam()-Funktion liefert einen Zeiger auf eine Struktur zurück, die die Gruppeninformation zur Gruppe name enthält. Diese Information wird aus der Datei /etc/group gelesen.

Die getgrgid()-Funktion liefert einen Zeiger auf eine Struktur zurück, die die Gruppeninformation zur Gruppe mit der GID gid enthält. Diese Information wird aus der Datei /etc/group gelesen.

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

    struct group {
            char    *gr_name;        /* Gruppenname */
            char    *gr_passwd;      /* Gruppenpasswort */
            gid_t   gr_gid;          /* Gruppen-id */
            char    **gr_mem;        /* Gruppenmitglieder */
    };

RÜCKGABEWERT
Die getgrnam()- und getgrgid()-Funktionen liefern die Gruppeninformationsstruktur zurück. Wurde der gesuchte Eintrag nicht gefunden oder trat ein Fehler auf, dann wird NULL zurückgeliefert.

FEHLER

ENOMEM
    Zuwenig Speicher um den Speicher für die Gruppeninformationsstruktur zu belegen.

DATEIEN
/etc/group Enthält die Informationen über die Gruppen.

KONFORM ZU
SVID 3, POSIX, BSD 4.3

SIEHE AUCH
fgetgrent(3), getgrent(3), setgrent(3), endgrent(3).