"Fossies" - the Fresh Open Source Software archive

Member "manpages-de-0.11/man3/getgrnam.3" of archive manpages-de_0.11.orig.tar.gz:


Table of Contents

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


Table of Contents