perkamon - en to fr translation catalogue (37 entries)

note: type: TH
en: 2019-03-06
fr: 6 mars 2019

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: getpwnam, getpwnam_r, getpwuid, getpwuid_r - get password file entry
fr: getpwnam, getpwnam_r, getpwuid, getpwuid_r - Lire un enregistrement du fichier des mots de passe

note: type: Plain text
en: Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):
fr: Exigences de macros de test de fonctionnalités pour la glibc (consultez B<feature_test_macros>(7)) :

note: type: Plain text
en: B<getpwnam_r>(), B<getpwuid_r>():
fr: B<getpwnam_r>(), B<getpwuid_r>() :

note: type: Plain text
en: The B<getpwnam>()  function returns a pointer to a structure containing the broken-out fields of the record in the password database (e.g., the local password file I</etc/passwd>, NIS, and LDAP)  that matches the username I<name>.
fr: La fonction B<getpwnam>() renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de la base de données des mots de passe (par exemple, la base de données locale I</etc/passwd>, NIS ou LDAP) correspondant au nom d'utilisateur I<name>.

note: type: Plain text
en: The B<getpwuid>()  function returns a pointer to a structure containing the broken-out fields of the record in the password database that matches the user ID I<uid>.
fr: La fonction B<getpwuid>() renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de la base de données des mots de passe correspondant à l'ID utilisateur I<uid>.

note: type: Plain text
en: The I<passwd> structure is defined in I<E<lt>pwd.hE<gt>> as follows:
fr: La structure I<passwd> est définie dans I<E<lt>pwd.hE<gt>> comme ceci\ :

note: type: Plain text
en: struct passwd {
        char   *pw_name;       /* username */
        char   *pw_passwd;     /* user password */
        uid_t   pw_uid;        /* user ID */
        gid_t   pw_gid;        /* group ID */
        char   *pw_gecos;      /* user information */
        char   *pw_dir;        /* home directory */
        char   *pw_shell;      /* shell program */
    };
fr: 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;        /* Répertoire personnel */
        char   *pw_shell;      /* Interpréteur de commande */
    };

note: type: Plain text
en: See B<passwd>(5)  for more information about these fields.
fr: Consultez B<passwd>(5) pour plus d'informations sur ces champs.

note: type: Plain text
en: The B<getpwnam_r>()  and B<getpwuid_r>()  functions obtain the same information as B<getpwnam>()  and B<getpwuid>(), but store the retrieved I<passwd> structure in the space pointed to by I<pwd>.  The string fields pointed to by the members of the I<passwd> structure are stored in the buffer I<buf> of size I<buflen>.  A pointer to the result (in case of success) or NULL (in case no entry was found or an error occurred) is stored in I<*result>.
fr: Les fonctions B<getpwnam_r>() et B<getpwuid_r>() fournissent les mêmes informations que B<getpwnam>() et B<getpwuid>() mais enregistrent la structure I<passwd> trouvée dans l'espace pointé par I<pwd>. Cette structure I<passwd> contient des pointeurs vers des chaînes qui sont enregistrées dans le tampon I<buf> de taille I<buflen>. Un pointeur vers le résultat (en cas de succès) ou NULL (au cas où aucune entrée n'ait été trouvée ou qu'une erreur soit survenue) est enregistré dans I<*result>.

note: type: Plain text
en: The call
fr: L'appel

note: type: Plain text
en: returns either -1, without changing I<errno>, or an initial suggested size for I<buf>.  (If this size is too small, the call fails with B<ERANGE>, in which case the caller can retry with a larger buffer.)
fr: renvoie soit -1 sans modifier I<errno>, soit une suggestion de taille initiale pour I<buf> (si cette taille est trop petite, l'appel échoue avec B<ERANGE>, auquel cas l'appelant peut réessayer avec un tampon plus grand).

note: type: SH
en: RETURN VALUE
fr: VALEUR DE RETOUR

note: type: Plain text
en: The B<getpwnam>()  and B<getpwuid>()  functions return a pointer to a I<passwd> structure, or NULL if the matching entry is not found or an error occurs.  If an error occurs, I<errno> is set appropriately.  If one wants to check I<errno> after the call, it should be set to zero before the call.
fr: Les fonctions B<getpwnam>() et B<getpwuid>() renvoient un pointeur sur une structure I<passwd>, ou NULL si une erreur se produit, ou si l'enregistrement correspondant n'est pas trouvé. En cas d'erreur, I<errno> est positionnée en conséquence. Si on souhaite vérifier I<errno> après l'appel, celle-ci devrait être positionnée à zéro avant l'appel.

note: type: Plain text
en: The return value may point to a static area, and may be overwritten by subsequent calls to B<getpwent>(3), B<getpwnam>(), or B<getpwuid>().  (Do not pass the returned pointer to B<free>(3).)
fr: La valeur de retour peut pointer vers une zone statique et donc être écrasée par des appels successifs à B<getpwent>(3), B<getpwnam>() ou B<getpwuid>(). (Ne pas passer le pointeur renvoyé à B<free>(3).)

note: type: Plain text
en: On success, B<getpwnam_r>()  and B<getpwuid_r>()  return zero, and set I<*result> to I<pwd>.  If no matching password record was found, these functions return 0 and store NULL in I<*result>.  In case of error, an error number is returned, and NULL is stored in I<*result>.
fr: En cas de succès, B<getpwnam_r>() et B<getpwuid_r>() renvoient zéro et définissent I<*result> à I<pwd>. Si aucun mot de passe ne correspond, ces fonctions renvoient 0 et définissent I<*result> à NULL. En cas d'erreur, un code d'erreur est renvoyé et I<*result> et définit à NULL.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: TP
en: B<0> or B<ENOENT> or B<ESRCH> or B<EBADF> or B<EPERM> or ...
fr: B<0> ou B<ENOENT> ou B<ESRCH> ou B<EBADF> ou B<EPERM> ou ...

note: type: Plain text
en: The given I<name> or I<uid> was not found.
fr: Le nom I<name> ou l'identifiant I<uid> n'ont pas été trouvés.

note: type: Plain text
en: I/O error.
fr: Erreur d'entrée-sortie.

note: not in POSIX This structure is static, allocated 0 or 1 times. No memory leak. (libc45) type: Plain text
en: Insufficient memory to allocate I<passwd> structure.
fr: Pas assez de mémoire pour allouer la structure I<passwd>.

note: type: Plain text
en: Insufficient buffer space supplied.
fr: L'espace tampon fourni est insuffisant.

note: type: SH
en: FILES
fr: FICHIERS

note: type: Plain text
en: local password database file
fr: Base de données des mots de passe locaux

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: tbl table
en: Value
fr: Valeur

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: more precisely: AIX 5.1 - gives ESRCH OSF1 4.0g - gives EWOULDBLOCK libc, glibc up to version 2.6, Irix 6.5 - give ENOENT glibc since version 2.7 - give 0 FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM SunOS 5.8 - gives EBADF Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0 type: Plain text
en: The formulation given above under "RETURN VALUE" is from POSIX.1-2001.  It does not call "not found" an error, and hence does not specify what value I<errno> might have in this situation.  But that makes it impossible to recognize errors.  One might argue that according to POSIX I<errno> should be left unchanged if an entry is not found.  Experiments on various UNIX-like systems show that lots of different values occur in this situation: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM, and probably others.
fr: La description "VALEUR RENVOYÉE" ci-dessus vient de POSIX.1-2001. Elle ne considère pas le cas «\ non trouvé\ » comme une erreur, et ne spécifie pas I<errno> dans ce cas. Cela rend la détection d'erreur impossible. On peut dire que, d'après POSIX, I<errno> est inchangée dans le cas où aucune entrée n'est trouvée. Des essais sur de nombreux systèmes UNIX ont fait apparaître différentes valeurs dans ce cas\ : 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM et probablement d'autres.

note: type: Plain text
en: The I<pw_dir> field contains the name of the initial working directory of the user.  Login programs use the value of this field to initialize the B<HOME> environment variable for the login shell.  An application that wants to determine its user's home directory should inspect the value of B<HOME> (rather than the value I<getpwuid(getuid())-E<gt>pw_dir>)  since this allows the user to modify their notion of "the home directory" during a login session.  To determine the (initial) home directory of another user, it is necessary to use I<getpwnam("username")-E<gt>pw_dir> or similar.
fr: Le champ I<pw_dir> contient le nom du répertoire de travail initial de l'utilisateur. Les programmes de connexion («\ login\ ») utilisent ce champ pour initialiser la variable d'environnement B<HOME> pour les interpréteurs de commandes initiaux. Une application qui souhaite déterminer le répertoire personnel des utilisateurs devrait lire la valeur de B<HOME> (au lieu de la valeur de I<getpwuid(getuid())-E<gt>pw_dir>) puisque que ceci permet à l'utilisateur de modifier «\ son répertoire personnel\ » lorsqu'il est connecté. Pour déterminer le répertoire personnel «\ initial\ » d'un autre utilisateur, il est nécessaire d'utiliser I<getpwnam("utilisateur")-E<gt>pw_dir> ou un équivalent.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The program below demonstrates the use of B<getpwnam_r>()  to find the full username and user ID for the username supplied as a command-line argument.
fr: Le programme suivant est un exemple d'utilisation de B<getpwnam_r>() pour trouver le nom complet et l'identifiant du nom d'utilisateur fourni en paramètre.

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.03 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.02 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.01 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.
