getpwent

Autres langues

Langue: fr

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NOM

getpwent, setpwent, endpwent - Lire un enregistrement 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 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), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd(5)

TRADUCTION

Christophe Blaess, 1996-2003.