Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       getpwnam,  getpwnam_r, getpwuid, getpwuid_r - Lire un enregistrement du
       fichier des mots de passe

SYNOPSIS

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

       struct passwd *getpwnam(const char *name);

       struct passwd *getpwuid(uid_t uid);

       int getpwnam_r(const char *name, struct passwd *pwd,
                   char *buf, size_t buflen, struct passwd **result);

       int getpwuid_r(uid_t uid, struct passwd *pwd,
                   char *buf, size_t buflen, struct passwd **result);

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

       getpwnam_r(), getpwuid_r() :
           _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
           _SVID_SOURCE || _POSIX_SOURCE

DESCRIPTION

       La fonction getpwnam() renvoie un pointeur sur une structure  contenant
       les divers champs de l'enregistrement de la base de donnees des mots de
       passe (par exemple, la base de donnees locale /etc/passwd, NIS ou LDAP)
       correspondant au nom d'utilisateur name.

       La  fonction getpwuid() renvoie un pointeur sur une structure contenant
       les divers champs de l'enregistrement de la base de donnees des mots de
       passe correspondant a l'ID utilisateur uid.

       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;      /* Information utilisateur */
               char   *pw_dir;        /* Repertoire personnel */
               char   *pw_shell;      /* Interpreteur de commande */
           };

       Consultez passwd(5) pour plus d'informations sur ces champs.

       Les  fonctions  getpwnam_r()  et  getpwuid_r()  fournissent  les  memes
       informations  que  getpwnam()  et  getpwuid()  mais   enregistrent   la
       structure  passwd trouvee dans l'espace pointe par pwd. Cette structure
       passwd contient des pointeurs vers des chaines  qui  sont  enregistrees
       dans  le  tampon buf de taille buflen. Un pointeur vers le resultat (en
       cas de succes) ou NULL (au cas ou aucune entree n'ait  ete  trouvee  ou
       qu'une erreur soit survenue) est enregistre dans *result.

       La taille maximale necessaire pour buf peut etre recuperee en utilisant
       sysconf(3) avec le parametre _SC_GETPW_R_SIZE_MAX.

VALEUR RENVOY'EE

       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 trouve. En cas d'erreur, errno
       est  positionnee  en  consequence.  Si on souhaite verifier errno apres
       l'appel, celle-ci devrait 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(3),  getpwnam()  ou
       getpwuid(). (Ne pas passer le pointeur renvoye a free(3).)

       En cas de  succes,  getpwnam_r()  et  getpwuid_r()  renvoient  zero  et
       definissent  *result  a  pwd.  Si aucun mot de passe ne correspond, ces
       fonctions renvoient 0 et definissent *result a NULL. En  cas  d'erreur,
       un code d'erreur est renvoye et *result et definit a NULL.

ERREURS

       0 ou ENOENT ou ESRCH ou EBADF ou EPERM ou ...
              Le nom name ou l'identifiant uid n'ont pas ete trouves.

       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.

NOTE

       La  base  de  donnees  des  mots de passe utilisateur est la plupart du
       temps /etc/passwd. Cependant, sur les systemes recents, elle peut faire
       reference a une base de donnees reseau NIS, LDAP et les autres fichiers
       locaux sont configures dans /etc/nsswitch.conf.

FICHIERS

       /etc/passwd
              Base de donnees des mots de passe locaux

       /etc/nsswitch.conf
              Fichier de configuration des base  de  donnees  systeme  et  des
              options des noms de services

CONFORMIT'E

       SVr4,  4.3BSD,  POSIX.1-2001. Le champ pw_gecos n'est pas specifie dans
       POSIX, mais il est present sur la plupart des implementations.

NOTES

       La description "VALEUR RENVOYEE" ci-dessus vient de POSIX.1-2001.  Elle
       ne  considere  pas  le  cas  << non  trouve >>  comme une erreur, et ne
       specifie pas errno  dans  ce  cas.  Cela  rend  la  detection  d'erreur
       impossible.  On  peut dire que, d'apres POSIX, errno est inchangee dans
       le cas ou aucune entree n'est  trouvee.  Des  essais  sur  de  nombreux
       systemes  UNIX ont fait apparaitre differentes valeurs dans ce cas : 0,
       ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM et probablement d'autres.

       Le champ pw_dir contient le nom du repertoire  de  travail  initial  de
       l'utilisateur.  Les  programmes de connexion (<< login >>) utilisent ce
       champ pour  initialiser  la  variable  d'environnement  HOME  pour  les
       interpreteurs  de  commandes  initiaux.  Une  application  qui souhaite
       determiner le repertoire personnel des  utilisateurs  devrait  lire  la
       valeur  de  HOME  (au  lieu de la valeur de getpwuid(getuid())->pw_dir)
       puisque que ceci permet a l'utilisateur de modifier  << son  repertoire
       personnel >>  lorsqu'il  est  connecte.  Pour  determiner le repertoire
       personnel << initial >>  d'un  autre  utilisateur,  il  est  necessaire
       d'utiliser getpwnam("utilisateur")->pw_dir ou un equivalent.

EXEMPLE

       Le  programme suivant est un exemple d'utilisation de getpwnam_r() pour
       trouver le nom complet et l'identifiant du nom d'utilisateur fourni  en
       parametre.

       #include <pwd.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <unistd.h>
       #include <errno.h>

       int
       main(int argc, char *argv[])
       {
           struct passwd pwd;
           struct passwd *result;
           char *buf;
           size_t bufsize;
           int s;

           if (argc != 2) {
               fprintf(stderr, "Usage: %s username\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           bufsize = sysconf(_SC_GETPW_R_SIZE_MAX);
           if (bufsize == -1)          /* Value was indeterminate */
               bufsize = 16384;        /* Should be more than enough */

           buf = malloc(bufsize);
           if (buf == NULL) {
               perror("malloc");
               exit(EXIT_FAILURE);
           }

           s = getpwnam_r(argv[1], &pwd, buf, bufsize, &result);
           if (result == NULL) {
               if (s == 0)
                   printf("Not found\n");
               else {
                   errno = s;
                   perror("getpwnam_r");
               }
               exit(EXIT_FAILURE);
           }

           printf("Name: %s; UID: %ld\n", pwd.pw_gecos, (long) pwd.pw_uid);
           exit(EXIT_SUCCESS);
       }

VOIR AUSSI

       endpwent(3),    fgetpwent(3),   getgrnam(3),   getpw(3),   getpwent(3),
       getspnam(3), putpwent(3), setpwent(3), nsswitch.conf(5), passwd(5)

COLOPHON

       Cette page fait partie de  la  publication  3.32  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/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-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> >>.