getpwent   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (3)
Updated: 26 juillet 2007
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
getpwent, setpwent, endpwent - Lire un enregistrement du fichier des mots de passe

Exigences de macros de test de fonctionalités pour la glibc (voir feature_test_macros(7)) :

getpwent(), setpwent(), endpwent() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE > = 500  




SYNOPSIS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
#include <sys/types.h>
#include <pwd.h>

struct passwd *getpwent (void);

void setpwent (void);

void endpwent (void);
 



DESCRIPTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
La fonction getpwent() renvoie un pointeur sur une structure contenant les divers champs d'un enregistrement de la base données des mots de passe (par exemple, le fichier local des mots de passe /etc/passwd, NIS ou LDAP) 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 la base de données des mots de passe.

La fonction endpwent() est utilisée pour fermer la base de données des mots de passe lorsque tous les traitements ont été effectués.

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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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. Si une erreur se produit, errno est remplie en conséquence. Si vous voulez vérifier errno après l'appel, vous devez la remplir avec zéro avant l'appel.  



ERREURS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
EINTR
Un signal a été intercepté.
EIO
Erreur d'entrée-sortie.
EMFILE
Le nombre maximum (OPEN_MAX) de fichiers a déjà été ouvert dans le processus appelant.
ENFILE
Le nombre maximum de fichiers a déjà été ouvert sur le système
ENOMEM
Pas assez de mémoire pour allouer la structure passwd.
ERANGE
Espace tampon fourni insuffisant.
 



FICHIERS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
/etc/passwd
Base de données locale des mots de passe.
 



CONFORMITÉ   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
SVr4, BSD 4.3, POSIX.1-2001.  



VOIR AUSSI   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
fgetpwent(3), getpw(3), getpwent_r(3), getpwnam(3), getpwuid(3), putpwent(3), passwd(5)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 3 novembre 1996 et révisée le 29 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 getpwent ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
FICHIERS
CONFORMITÉ
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
EINTRERREURS
EIOERREURS
EMFILEERREURS
ENFILEERREURS
ENOMEMERREURS
ERANGEERREURS



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:49:28, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional