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

NOM

       getpwent,  setpwent,  endpwent  - Lire un enregistrement du fichier des
       mots de passe

SYNOPSIS

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

       struct passwd *getpwent(void);

       void setpwent(void);

       void endpwent(void);

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

       getpwent(), setpwent(), endpwent() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
           _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED

DESCRIPTION

       La fonction getpwent() renvoie un pointeur sur une structure  contenant
       les divers champs d'un enregistrement de la base de donnees des mots de
       passe (par exemple, le fichier de mots de passe local /etc/passwd,  NIS
       ou   LDAP).   Au   premier   appel,   getpwent()   renvoie  le  premier
       enregistrement, puis  les  enregistrements  suivants  lors  des  appels
       suivants.

       La  fonction  setpwent() ramene le pointeur de fichier au debut de base
       de donnees des mots de passe.

       La fonction endpwent() est utilisee pour fermer la base de donnees  des
       mots de passe apres que toutes les actions ont ete realisees.

       La structure passwd est definie dans <pwd.h> comme ceci :

           struct passwd {
               char   *pw_name;       /* Nom d'utilisateur */
               char   *pw_passwd;     /* Mot de passe de l'utilisateur */
               uid_t   pw_uid;        /* ID de l'utilisateur */
               gid_t   pw_gid;        /* ID du groupe */
               char   *pw_gecos;      /* Nom reel */
               char   *pw_dir;        /* Repertoire personnel */
               char   *pw_shell;      /* Interpreteur de commande */
           };

       Lorsque  les mots de passe shadow(5) sont actives (ce qui est le defaut
       sur beaucoup de distribution GNU/Linux), le contenu de pw_passwd  n'est
       habituellement  pas  utile.  Dans  un  tel  cas, les mots de passe sont
       enregistres dans des fichiers separes.

       La variable pw_shell peut etre vide, dans ce cas,  le  systeme  utilise
       l'interpreteur de commandes par defaut (/bin/sh) pour l'utilisateur.

VALEUR RENVOY'EE

       La fonction getpwent() renvoie un pointeur sur une structure passwd, ou
       NULL si une erreur se produit ou s'il n'y a plus  d'enregistrement.  En
       cas  d'erreur,  errno est positionnee en consequence. Si vous souhaitez
       verifier errno apres l'appel, celle-ci doit  etre  positionnee  a  zero
       avant l'appel.

       La  valeur  de  retour peut pointer vers une zone statique et donc etre
       ecrasee  par  des  appels  successifs  a  getpwent(),  getpwnam(3)   ou
       getpwuid(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  (OPEN_MAX)  de  fichiers  ouverts  par  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 passwd.

       ERANGE L'espace tampon fourni est insuffisant.

FICHIERS

       /etc/passwd
              Base de donnees des mots de passe locaux

CONFORMIT'E

       SVr4, BSD 4.3, POSIX.1-2001.

VOIR AUSSI

       fgetpwent(3),   getpw(3),   getpwent_r(3),   getpwnam(3),  getpwuid(3),
       putpwent(3), shadow(5), passwd(5)

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/>.

       Alain Portal  <URL:http://manpagesfr.free.fr/> (2004-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> >>.