Fonctions
des bibliothèques (section 3) getpwnam
Nom
getpwnam, getpwuid - Lire un enregistrement du fichier des mots de passe.Synopsis
#include <pwd.h>#include <sys/types.h> struct passwd *getpwnam (const char * name); struct passwd *getpwuid (uid_t uid);
Description
La fonction getpwnam() renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de /etc/passwd correspondant au nom d'utilisateur name.La fonction getpwuid() renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de /etc/passwd correspondant au à l'ID d'utilisateur uid.
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
Les fonctions getpwnam() et getpwuid() renvoient une structure
passwd, ou NULL si une erreur se produit, ou si l'enregistrement correspondant
n'est pas trouvé.
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, POSIX, BSD 4.3Voir Aussi
fgetpwent(3) , getpwent(3) , setpwent(3) , endpwent(3) , getpw(3) , putpwent(3) , passwd(5) .
Traduction
Christophe Blaess, 1997.