GETPWENT

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
FICHIERS
CONFORMITÉ À
VOIR AUSSI
TRADUCTION

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);

DESCRIPTION

La fonction getpwent() renvoie un pointeur sur une structure contenant les divers champs d'un enregistrement de la base de données des mots de passe (par exemple, le fichier de mots de passe local /etc/passwd, NIS ou LDAP). Au premier appel, elle renvoie le premier enregistrement, puis les enregistrements suivants lors des appels suivants.
La fonction setpwent() ramène le pointeur de fichier au début de 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 après que toutes les actions aient été réalisées.
La structure passwd est définie dans <pwd.h> ainsi :

struct passwd {
    char   *pw_name;       /* nom de l'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 réel */
    char   *pw_dir;        /* répertoire personnel */
    char   *pw_shell;      /* shell */
};

Lorsque les mots de passe shadow(5) sont activés (ce qui est le défaut 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 enregistrés dans des fichiers séparés.
La variable pw_shell peut être vide, dans ce cas, le système utilise l'interpréteur de commandes par défaut (/bin/sh) pour l'utilisateur.

VALEUR RENVOYÉE

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 positionnée en conséquence. Si vous souhaitez vérifier errno après l'appel, celle-ci doit être positionnée à zéro avant l'appel.

ERREURS

EINTR: Un signal a été capturé.
EIO: Erreur d'entrée-sortie.
EMFILE: Le nombre maximal (OPEN_MAX) de fichiers ouverts pour le processus est atteint.
ENFILE: Le nombre maximal de fichiers ouverts sur le système est atteint.
ENOMEM: Pas assez de mémoire pour allouer la structure passwd.
ERANGE: L'espace tampon fourni est insuffisant.

FICHIERS

/etc/passwd: Base de données des mots de passe locaux

CONFORMITÉ À

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)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Alain Portal <aportal AT univ-montp2 DOT fr> entre 2004 et 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007