getpwnam(3) Library Functions Manual getpwnam(3) NOM getpwnam, getpwnam_r, getpwuid, getpwuid_r -- Lire un enregistrement du fichier des mots de passe BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include #include struct passwd *getpwnam(const char *nom); struct passwd *getpwuid(uid_t uid); int getpwnam_r(const char *restrict nom, struct passwd *restrict pwd, char tampon[restrict .taille_tampon], size_t taille_tampon, struct passwd **restrict result); int getpwuid_r(uid_t uid, struct passwd *restrict pwd, char tampon[restrict .taille_tampon], size_t taille_tampon, struct passwd **restrict result); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : getpwnam_r(), getpwuid_r() : _POSIX_C_SOURCE || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_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 nom. 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 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 de taille taille_tampon. 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. L'appel sysconf(_SC_GETPW_R_SIZE_MAX) renvoie soit -1 sans modifier errno, soit une suggestion de taille initiale pour buf (si cette taille est trop petite, l'appel echoue avec ERANGE, auquel cas l'appelant peut reessayer avec un tampon plus grand). VALEUR RENVOYEE 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 definie pour indiquer l'erreur. Si on souhaite verifier errno apres l'appel, celle-ci doit etre definie 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 0 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 est defini a NULL. ERREURS 0 ou ENOENT ou ESRCH ou EBADF ou EPERM ou ... Le nom nom ou l'identifiant uid n'ont pas ete trouves. EINTR Un signal a ete intercepte ; consultez signal(7). EIO Erreur d'entree-sortie. EMFILE La limite du nombre de descripteurs de fichiers par processus a ete atteinte. ENFILE La limite du nombre total de fichiers ouverts pour le systeme entier a ete atteinte. ENOMEM Pas assez de memoire pour allouer la structure passwd. ERANGE L'espace tampon fourni est insuffisant. FICHIERS /etc/passwd Base de donnees locale des mots de passe ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +--------------+--------------------------+----------------------------+ |Interface | Attribut | Valeur | +--------------+--------------------------+----------------------------+ |getpwnam() | Securite des threads | MT-Unsafe race:pwnam | | | | locale | +--------------+--------------------------+----------------------------+ |getpwuid() | Securite des threads | MT-Unsafe race:pwuid | | | | locale | +--------------+--------------------------+----------------------------+ |getpwnam_r(), | Securite des threads | MT-Safe locale | |getpwuid_r() | | | +--------------+--------------------------+----------------------------+ VERSIONS Le champ pw_gecos n'est pas specifie dans POSIX, mais il est present sur la plupart des implementations. STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001, SVr4, 4.3BSD. 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 doit lire la valeur de HOME (au lieu de la valeur de getpwuid(getuid())->pw_dir) puisque cela 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. EXEMPLES 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 #include #include #include #include #include int main(int argc, char *argv[]) { struct passwd pwd; struct passwd *result; char *buf; long bufsize; int s; if (argc != 2) { fprintf(stderr, "Utilisation : %s nom utilisateur\n", argv[0]); exit(EXIT_FAILURE); } bufsize = sysconf(_SC_GETPW_R_SIZE_MAX); if (bufsize == -1) /* Valeur indeterminee */ bufsize = 16384; /* Devrait largement suffire */ buf = malloc(bufsize); if (buf == NULL) { perror( exit(EXIT_FAILURE); } s = getpwnam_r(argv[1], &pwd, buf, bufsize, &result); if (result == NULL) { if (s == 0) printf("Non trouve\n"); else { errno = s; perror("getpwnam_r"); } exit(EXIT_FAILURE); } printf("Nom : %s; UID : %jd\n", pwd.pw_gecos, (intmax_t) pwd.pw_uid); exit(EXIT_SUCCESS); } VOIR AUSSI endpwent(3), fgetpwent(3), getgrnam(3), getpw(3), getpwent(3), getspnam(3), putpwent(3), setpwent(3), passwd(5) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 getpwnam(3)