Provided by: manpages-fr-dev_2.64.1-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);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

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

DESCRIPTION

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

       La  fonction  setgrent()  ramène  le  pointeur  au  début de la base de
       données de groupe pour permettre des balayages répétitifs.

       La fonction endgrent() est utilisée pour fermer la base de  données  de
       groupe après que toutes les actions aient été réalisées.

       La structure group est définie dans <grp.h> de la manière suivante :

          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 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  être  positionnée.  Si  vous souhaitez
       vérifier sa valeur, il est nécessaire de la positionner  à  zéro  avant
       l’appel.

ERREURS

       EINTR  Un signal a été capturé.

       EIO    Erreur d’entrée-sortie.

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

       ENFILE Le nombre  maximal  de  fichiers  ouverts  sur  le  système  est
              atteint.

       ENOMEM Pas  assez de mémoire pour allouer la structure d’information de
              groupe.

       ERANGE L’espace tampon fourni est insuffisant.

FICHIERS

       /etc/group
              Base de données des groupes locaux

CONFORMITÉ À

       SVr4, BSD 4.3, POSIX.1-2001.

VOIR AUSSI

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

TRADUCTION

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

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

       Vous  pouvez  toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « man -L C <section> <page_de_man> ».

                                  2007-07-26                       GETGRENT(3)