GETGRENT(3)

NOM
getgrent, setgrent, endgrent - Lire / ecrire les enregistrement du fichier des groupes.

SYNOPSIS
#include <grp.h>
#include <sys/types.h>

struct group *getgrent (void);

void setgrent (void);

void endgrent (void);

DESCRIPTION
La fonction getgrent() renvoie un pointeur sur une structure contenant les enregistrements de groupes issus de /etc/group(5). Au premier appel elle renvoie le premier enregistrement, puis les autres enregistrements lors des autres appels successifs.

La fonction setgrent() ramene le pointeur au debut du fichier /etc/group.

La fonction endgrent() ferme le fichier /etc/group.

La structure group est definie dans <grp.h> ainsi :

    struct group {
         char   *gr_name;    /* Nom du groupe.          */
         char   *gr_passwd;  /* Mot de passe du groupe. */
         gid_t   gr_gid;     /* ID du groupe.           */
         char  **gr_mem;     /* Membres du groupe.      */
    };

VALEUR RENVOYEE
La fonction getgrent() renvoie la structure de groupe, ou NULL s'il n'y a plus d'enregistrements, ou si une erreur se produit.

ERREURS

ENOMEM
    Pas assez de memoire pour allouer une structure.

FICHIERS

/etc/group
    Base de donnees des groupes.

CONFORME A
SVID 3, BSD 4.3

VOIR AUSSI
fgetgrent(3), getgrnam(3), getgrgid(3)