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   fonctionnalités   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 données 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() ramène le pointeur de fichier au début de base de données des  mots
       de passe.

       La fonction endpwent() est utilisée pour fermer la base de données des mots de passe après
       que toutes les actions ont été réalisées.

       La structure passwd est définie 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;      /* Information utilisateur */
               char   *pw_dir;        /* Répertoire personnel */
               char   *pw_shell;      /* Interpréteur de commande */
           };

       Lorsque les mots de passe shadow(5) sont activés (ce qui est le  comportement  par  défaut
       sur beaucoup de distributions GNU/Linux), le contenu de pw_passwd n'est habituellement pas
       utile. Dans un tel cas, les mots de passe sont enregistrés dans un fichier séparé.

       La variable pw_shell peut être vide, dans ce cas, le  système  utilise  l'interpréteur  de
       commandes par défaut (/bin/sh) pour l'utilisateur.

       Pour plus d'informations à propos des champs de cette structure, consultez passwd(5).

VALEUR RENVOYÉE

       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 positionnée  en
       conséquence.   Si  vous  souhaitez  vérifier  errno  après  l'appel,  celle-ci  doit  être
       positionnée à zéro avant l'appel.

       La valeur de retour peut pointer vers une zone statique  et  donc  être  écrasée  par  des
       appels  successifs  à  getpwent(),  getpwnam(3) ou getpwuid(3). (Ne pas passer le pointeur
       renvoyé à free(3).)

ERREURS

       EINTR  Un signal a été intercepté.

       EIO    Erreur d'entrée-sortie.

       EMFILE Le nombre maximal (OPEN_MAX) de fichiers ouverts par 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 passwd.

       ERANGE L'espace tampon fourni est insuffisant.

FICHIERS

       /etc/passwd
              Base de données des mots de passe locaux

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction getpwent() n'est pas sûre dans un contexte multithread.

       Les fonctions setpwent() et endpwent() sont sûres dans un contexte multithread.

CONFORMITÉ

       SVr4, 4.3BSD, POSIX.1-2001. Le champ pw_gecos n'est pas spécifié dans POSIX, mais  il  est
       présent sur la plupart des implémentations.

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.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

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

       Alain  Portal  <http://manpagesfr.free.fr/> (2004-2006).  Florentin  Duneau  et   l'équipe
       francophone de traduction de Debian (2006-2009).

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