GETPWENT(3)        Manuel du programmeur Linux        GETPWENT(3)


NOM
       getpwent,  setpwent,  endpwent  -  Lire/écrire  un  enreg­
       istrement du fichier des mots de passe.

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

       struct passwd *getpwent (void);

       void setpwent (void);

       void endpwent (void);

DESCRIPTION
       La fonction getpwent() renvoie un pointeur sur une  struc­
       ture  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




BSD                      3 Novembre 1996                        1





GETPWENT(3)        Manuel du programmeur Linux        GETPWENT(3)


VOIR AUSSI
       fgetpwent(3), getpwnam(3),  getpwuid(3),  getpw(3),  putp­
       went(3), passwd(5).


TRADUCTION
       Christophe Blaess, 1997.


















































BSD                      3 Novembre 1996                        2