getgrent

Autres langues

Langue: fr

Autres versions - même langue

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NOM

getgrent, setgrent, endgrent - Lire 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.3

VOIR AUSSI

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

TRADUCTION

Christophe Blaess, 1996-2003.