Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
getpwent, setpwent, endpwent - Lire un enregistrement du fichier des
mots de passe
SYNOPSIS
#include <sys/types.h>
#include <pwd.h>
struct passwd *getpwent(void);
void setpwent(void);
void endpwent(void);
Exigences de macros de test de fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
getpwent(), setpwent(), endpwent() :
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
DESCRIPTION
La fonction getpwent() renvoie un pointeur sur une structure contenant
les divers champs d'un enregistrement de la base de donnees des mots de
passe (par exemple, le fichier de mots de passe local /etc/passwd, NIS
ou LDAP). Au premier appel, getpwent() renvoie le premier
enregistrement, puis les enregistrements suivants lors des appels
suivants.
La fonction setpwent() ramene le pointeur de fichier au debut de base
de donnees des mots de passe.
La fonction endpwent() est utilisee pour fermer la base de donnees des
mots de passe apres que toutes les actions ont ete realisees.
La structure passwd est definie dans <pwd.h> comme ceci :
struct passwd {
char *pw_name; /* Nom d'utilisateur */
char *pw_passwd; /* Mot de passe de l'utilisateur */
uid_t pw_uid; /* ID de l'utilisateur */
gid_t pw_gid; /* ID du groupe */
char *pw_gecos; /* Nom reel */
char *pw_dir; /* Repertoire personnel */
char *pw_shell; /* Interpreteur de commande */
};
Lorsque les mots de passe shadow(5) sont actives (ce qui est le defaut
sur beaucoup de distribution GNU/Linux), le contenu de pw_passwd n'est
habituellement pas utile. Dans un tel cas, les mots de passe sont
enregistres dans des fichiers separes.
La variable pw_shell peut etre vide, dans ce cas, le systeme utilise
l'interpreteur de commandes par defaut (/bin/sh) pour l'utilisateur.
VALEUR RENVOY'EE
La fonction getpwent() renvoie un pointeur sur une structure passwd, ou
NULL si une erreur se produit ou s'il n'y a plus d'enregistrement. En
cas d'erreur, errno est positionnee en consequence. Si vous souhaitez
verifier errno apres l'appel, celle-ci doit etre positionnee a zero
avant l'appel.
La valeur de retour peut pointer vers une zone statique et donc etre
ecrasee par des appels successifs a getpwent(), getpwnam(3) ou
getpwuid(3). (Ne pas passer le pointeur renvoye a free(3).)
ERREURS
EINTR Un signal a ete intercepte.
EIO Erreur d'entree-sortie.
EMFILE Le nombre maximal (OPEN_MAX) de fichiers ouverts par le
processus est atteint.
ENFILE Le nombre maximal de fichiers ouverts sur le systeme est
atteint.
ENOMEM Pas assez de memoire pour allouer la structure passwd.
ERANGE L'espace tampon fourni est insuffisant.
FICHIERS
/etc/passwd
Base de donnees des mots de passe locaux
CONFORMIT'E
SVr4, BSD 4.3, POSIX.1-2001.
VOIR AUSSI
fgetpwent(3), getpw(3), getpwent_r(3), getpwnam(3), getpwuid(3),
putpwent(3), shadow(5), passwd(5)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Alain Portal <URL:http://manpagesfr.free.fr/> (2004-2006). Florentin
Duneau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.