GETPWNAM

Section: Manuel du programmeur Linux (3)
Updated: 6 juin 2001
Index Retour au Menu Principal

 

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 un pointeur sur 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.3  

VOIR AUSSI

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

TRADUCTION

Christophe Blaess, 1997.



 

Index

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


Time: 22:30:02 GMT, December 19, 2004