GETPWENT(3) Manuel du programmeur Linux GETPWENT(3) NOM getpwent, setpwent, endpwent - Lire un enregistrement du fichier des mots de passe. SYNOPSIS #include <pwd.h> #include <sys/types.h> struct passwd(1,5) *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(1,5). Au pre- mier appel, elle renvoie le premier enregistrement, puis les autres enregistrements lors des appels successifs. La fonction setpwent() ramne le pointeur de fichier au dbut de /etc/passwd(1,5). La fonction endpwent() ferme le fichier /etc/passwd(1,5). La structure passwd(1,5) est dfinie dans <pwd.h> ainsi : struct passwd(1,5) { 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 rel de l'utilisateur */ char *pw_dir; /* Rpertoire de connexion */ char *pw_shell; /* Programme Shell de connexion */ }; VALEUR RENVOYE La fonction getpwent() renvoie une structure passwd(1,5) ou un pointeur NULL s'il n'y a plus d'enregistrements, ou si une erreur se produit. ERREURS ENOMEM Pas assez de mmoire pour allouer la structure passwd. FICHIERS /etc/passwd(1,5) Base de donnes des mots de passe. CONFORMIT SVID 3, BSD 4.3 VOIR AUSSI fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd(1,5)(5) TRADUCTION Christophe Blaess, 1996-2003. LDP 21 juillet 2003 GETPWENT(3)