Fonctions
des bibliothèques (section 3) getgrent
Nom
getgrent, setgrent, endgrent - Lire / écrire 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() 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. */ };
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.
Conformité
SVID 3, BSD 4.3Voir Aussi
fgetgrent(3) , getgrnam(3) , getgrgid(3)
Traduction
Christophe Blaess, 1997.