getgrent, setgrent, endgrent − Lire / écrire les enregistrement du fichier des groupes.

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

struct group *getgrent (void);

void setgrent (void);

void endgrent (void);

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() ramène le pointeur au début du fichier /etc/group.

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

La structure group est définie 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.      */
};

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

ENOMEM

Pas assez de mémoire pour allouer une structure.

/etc/group

Base de données des groupes.

SVID 3, BSD 4.3

fgetgrent(3), getgrnam(3), getgrgid(3)

Christophe Blaess, 1997.