Rechercher une page de manuel
getpwent
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.3VOIR AUSSI
fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd(5)TRADUCTION
Christophe Blaess, 1996-2003.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre