Provided by: manpages-fr_1.67.0-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);


DESCRIPTION
       La fonction getpwent() renvoie un pointeur sur une structure  contenant
       les  divers  champs  de  la  ligne suivante du fichier /etc/passwd.  Au
       premier appel, elle renvoie le premier enregistrement, puis les  autres
       enregistrements lors des appels successifs.

       La  fonction  setpwent()  ramène  le  pointeur  de  fichier au début de
       /etc/passwd.

       La fonction endpwent() ferme le fichier /etc/passwd.

       La structure passwd est définie dans <pwd.h> ainsi :

              struct passwd {
                char   *pw_name;   /* Nom d’utilisateur             */
                char   *pw_passwd; /* Mot de passe                  */
                uid_t   pw_uid;    /* ID de l’utilisateur           */
                gid_t   pw_gid;    /* ID du groupe de l’utilisateur */
                char   *pw_gecos;  /* Nom réel de l’utilisateur     */
                char   *pw_dir;    /* Répertoire de connexion       */
                char   *pw_shell;  /* Programme Shell de connexion  */
              };


VALEUR RENVOYÉE
       La fonction getpwent() renvoie une structure passwd ou un pointeur NULL
       s’il n’y a plus d’enregistrements, ou si une erreur se produit.


ERREURS
       ENOMEM Pas assez de mémoire pour allouer la structure passwd.


FICHIERS
       /etc/passwd
              Base de données des mots de passe.


CONFORMITÉ
       SVID 3, BSD 4.3


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


TRADUCTION
       Christophe Blaess, 1996-2003.