getpwnam, getpwuid − Lire un enregistrement du fichier des mots de passe.

#include <pwd.h>
#include <sys/types.h>

struct passwd *getpwnam (const char * name);

struct passwd *getpwuid (uid_t uid);

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  */
};

Les fonctions getpwnam() et getpwuid() renvoient un pointeur sur une structure passwd, ou NULL si une erreur se produit, ou si l’enregistrement correspondant n’est pas trouvé.

ENOMEM

Pas assez de mémoire pour allouer la structure passwd.

/etc/passwd

Base de données des mots de passe.

SVID 3, POSIX, BSD 4.3

fgetpwent(3), getgrnam(3), getpwent(3), setpwent(3), endpwent(3), getpw(3), putpwent(3), passwd(5)

Christophe Blaess, 1997.