Nom

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

Résumé

.nf #include <grp.h> #include <sys/types.h> struct group *getgrent (void); void setgrent (void); void endgrent (void); .fi

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() 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 :

.nf .ta 8n 16n 32n 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. */ }; .ta .fi

Valeur renvoyée

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 mémoire pour allouer une structure.

Fichiers

/etc/group

Base de données des groupes. .fi

Conformité

SVID 3, BSD 4.3

Voir aussi

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

Traduction

Christophe Blaess, 1996-2003.