Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       getgrent,  setgrent,  endgrent - Lire les enregistrements du fichier de
       groupes

SYNOPSIS

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

       struct group *getgrent(void);

       void setgrent(void);

       void endgrent(void);

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

       setgrent(),
           _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 ||
           _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
           /* Depuis la glibc 2.12 : */ _POSIX_C_SOURCE >= 200809L

       getgrent(), endgrent() :
           _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 ||
           _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED

DESCRIPTION

       La  fonction getgrent() renvoie un pointeur sur une structure contenant
       les champs d'un enregistrement de la base de  donnees  de  groupe  (par
       exemple,  le  fichier  de  groupe  local  /etc/group,  NIS ou LDAP). Au
       premier appel, getgrent() renvoie le premier enregistrement,  puis  les
       autres enregistrements lors des appels successifs.

       La  fonction  setgrent()  ramene  le  pointeur  au  debut de la base de
       donnees de groupe pour permettre des balayages repetitifs.

       La fonction endgrent() est utilisee pour fermer la base de  donnees  de
       groupe apres que toutes les actions ont ete realisees.

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

           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'EE

       La  fonction getgrent() renvoie un pointeur vers une structure group ou
       un pointeur NULL s'il n'y a plus d'enregistrement, ou si une erreur  se
       produit.

       En  cas  d'erreur,  errno  peut  etre  positionnee.  Si  vous souhaitez
       verifier sa valeur, il est necessaire de la positionner  a  zero  avant
       l'appel.

       La  valeur  de  retour peut pointer sur une zone de memoire statique et
       peut etre ecrasee par des appels successifs a  getgrent(),  getgrgid(3)
       ou getgrnam(3). (Ne pas passer le pointeur renvoye a free(3).)

ERREURS

       EINTR  Un signal a ete intercepte.

       EIO    Erreur d'entree-sortie.

       EMFILE Le  nombre  maximal  de  fichiers  ouverts pour le processus est
              atteint.

       ENFILE Le nombre  maximal  de  fichiers  ouverts  sur  le  systeme  est
              atteint.

       ENOMEM Pas assez de memoire pour allouer la structure group.

       ERANGE L'espace tampon fourni est insuffisant.

FICHIERS

       /etc/group
              Base de donnees des groupes locaux

CONFORMIT'E

       SVr4, BSD 4.3, POSIX.1-2001.

VOIR AUSSI

       fgetgrent(3), getgrent_r(3), getgrgid(3), getgrnam(3), getgrouplist(3),
       putgrent(3)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue a l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-2006).  Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                               20 septembre 2010                   GETGRENT(3)