getpw(3)                   Library Functions Manual                   getpw(3)

NOM
       getpw - Reconstruire un enregistrement de mot de passe

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #define _GNU_SOURCE             /* Consultez feature_test_macros(7) */
       #include <sys/types.h>
       #include <pwd.h>

       [[obsolete]] int getpw(uid_t uid, char *buf);

DESCRIPTION
       La fonction getpw() reconstruit l'enregistrement de la ligne de mot de
       passe de l'utilisateur uid et le place dans le tampon buf. Ce tampon
       contient en retour une ligne au format suivant :

           name:passwd:uid:gid:gecos:dir:shell

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

       Pour plus d'informations a propos des champs de cette structure,
       consultez passwd(5).

VALEUR RENVOYEE
       Si elle reussit, la fonction getpw() renvoie 0. En cas d'erreur, elle
       renvoie -1 et definit errno en consequence.

       Si l'uid n'est pas trouve dans la base de donnees de mots de passe,
       getpw() renvoie -1, definit errno a 0 et laisse buf inchange.

ERREURS
       0 ou ENOENT
              Pas d'utilisateur correspondant a uid.

       EINVAL buf est NULL.

       ENOMEM Pas assez de memoire pour allouer la structure passwd.

FICHIERS
       /etc/passwd
              Fichier de base de donnees des mots de passe

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +--------------------------+--------------------------+----------------+
       |Interface                 | Attribut                 | Valeur         |
       +--------------------------+--------------------------+----------------+
       |getpw()                   | Securite des threads     | MT-Safe locale |
       +--------------------------+--------------------------+----------------+
STANDARDS
       Aucun.

HISTORIQUE
       SVr2.

BOGUES
       La fonction getpw() est dangereuse car elle peut provoquer un
       debordement du tampon buf. Elle est rendue obsolete par getpwuid(3).

VOIR AUSSI
       endpwent(3), fgetpwent(3), getpwent(3), getpwnam(3), getpwuid(3),
       putpwent(3), setpwent(3), passwd(5)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org> et David Prevot
       <david@tilapin.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> 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 <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                       getpw(3)