getgrnam

Autres langues

Langue: de

Version: 6. Juni 1996 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

BEZEICHNUNG

getgrnam, getgrgid - liest den Usergruppendateieintrag

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