perkamon - en to fr translation catalogue (35 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: pthread_setname_np, pthread_getname_np - set/get the name of a thread
fr: pthread_setname_np, pthread_getname_np - Définir ou obtenir le nom d'un thread

note: type: Plain text
en: B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */
    B<#include E<lt>pthread.hE<gt>>
    B<int pthread_setname_np(pthread_t >I<thread>B<, const char *>I<name>B<);>
    B<int pthread_getname_np(pthread_t >I<thread>B<,>
    B<                       char *>I<name>B<, size_t >I<len>B<);>
fr: B<#define _GNU_SOURCE>             /* Consultez feature_test_macros(7) */
    B<#include E<lt>pthread.hE<gt>>
    B<int pthread_setname_np(pthread_t >I<thread>B<, const char *>I<name>B<);>
    B<int pthread_getname_np(pthread_t >I<thread>B<,>
    B<                       char *>I<name>B<, size_t >I<len>B<);>

note: type: Plain text
en: Compile and link with I<-pthread>.
fr: Compilez et effectuez l'édition des liens avec l'option I<-pthread>.

note: type: Plain text
en: By default, all the threads created using B<pthread_create>()  inherit the program name.  The B<pthread_setname_np>()  function can be used to set a unique name for a thread, which can be useful for debugging multithreaded applications.  The thread name is a meaningful C language string, whose length is restricted to 16 characters, including the terminating null byte (\(aq\e0\(aq).  The I<thread> argument specifies the thread whose name is to be changed; I<name> specifies the new name.
fr: Par défaut, tous les threads créés par B<pthread_create>() héritent du nom de programme. La fonction B<pthread_setname_np>() permet d'affecter un nom propre à un thread, ce qui peut être utile pour déboguer une application multithread. Le nom du thread est une chaîne de langage C significative, dont la longueur ne peut dépasser 16 caractères, caractère nul final (\(aq\e0\(aq) inclus. L'argument I<thread> indique le thread dont le nom doit être changé ; le nouveau nom est précisé dans I<name>.

note: type: Plain text
en: The B<pthread_getname_np>()  function can be used to retrieve the name of the thread.  The I<thread> argument specifies the thread whose name is to be retrieved.  The buffer I<name> is used to return the thread name; I<len> specifies the number of bytes available in I<name>.  The buffer specified by I<name> should be at least 16 characters in length.  The returned thread name in the output buffer will be null terminated.
fr: La fonction B<pthread_getname_np>() permet de récupérer le nom du thread. L'argument I<thread> indique le thread dont le nom doit être récupéré. Le tampon I<name> est utilisé pour renvoyer le nom du thread ; I<len> indique le nombre d'octets disponibles dans I<name>. La longueur du tampon indiqué dans I<name> doit être d'au moins 16 caractères. Le nom du thread renvoyé dans le tampon de retour est terminé par caractère nul.

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

note: type: Plain text
en: On success, these functions return 0; on error, they return a nonzero error number.
fr: En cas de réussite, ces fonctions renvoient 0 ; en cas d'erreur elles renvoient un numéro d'erreur non nul.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The B<pthread_setname_np>()  function can fail with the following error:
fr: La fonction B<pthread_setname_np>() peut échouer avec l'erreur suivante :

note: type: Plain text
en: The length of the string specified pointed to by I<name> exceeds the allowed limit.
fr: La longueur de la chaîne vers laquelle pointe I<name> dépasse la limite autorisée.

note: type: Plain text
en: The B<pthread_getname_np>()  function can fail with the following error:
fr: La fonction B<pthread_getname_np>() peut échouer avec l'erreur suivante :

note: type: Plain text
en: The buffer specified by I<name> and I<len> is too small to hold the thread name.
fr: Le tampon indiqué par I<name> et I<len> a une taille insuffisante pour contenir le nom du thread.

note: type: Plain text
en: If either of these functions fails to open I</proc/self/task/[tid]/comm>, then the call may fail with one of the errors described in B<open>(2).
fr: Si l'une de ces fonctions ne parvient pas à ouvrir I</proc/self/task/[tid]/comm>, alors l'appel peut échouer en retournant l'une des erreurs décrites dans B<open>(2)

note: type: Plain text
en: These functions first appeared in glibc in version 2.12.
fr: Ces fonctions ont été introduites dans la glibc dans sa version 2.12.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

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

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

note: type: Plain text
en: These functions are nonstandard GNU extensions; hence the suffix "_np" (nonportable) in the names.
fr: Ces fonctions sont des extensions non standard GNU ; c'est la raison du suffixe « _np » (non portable) dans leur nom.

note: type: Plain text
en: B<pthread_setname_np>()  internally writes to the thread-specific I<comm> file under the I</proc> filesystem: I</proc/self/task/[tid]/comm>.  B<pthread_getname_np>()  retrieves it from the same location.
fr: B<pthread_setname_np>() écrit en interne dans le fichier I<comm> du thread (dans le système de fichiers I</proc>) : I</proc/self/task/[tid]/comm>. B<pthread_getname_np>() récupère le nom du thread à ce même endroit.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The program below demonstrates the use of B<pthread_setname_np>()  and B<pthread_getname_np>().
fr: Le programme ci-dessous illustre l'utilisation de B<pthread_setname_np>() et de B<pthread_getname_np>().

note: type: Plain text
en: The following shell session shows a sample run of the program:
fr: La session d'interpréteur de commande ci-dessous montre l'exécution du programme :

note: type: Plain text
en: $B< ./a.out>
    Created a thread. Default name is: a.out
    The thread name after setting it is THREADFOO.
    B<^Z>                           # Suspend the program
    [1]+  Stopped           ./a.out
    $ B<ps H -C a.out -o 'pid tid cmd comm'>
      PID   TID CMD                         COMMAND
     5990  5990 ./a.out                     a.out
     5990  5991 ./a.out                     THREADFOO
    $ B<cat /proc/5990/task/5990/comm>
    a.out
    $ B<cat /proc/5990/task/5991/comm>
    THREADFOO
fr: $B< ./a.out>
    Thread créé. Le nom par défaut est : a.out
    Le nom du thread après nommage est THREADFOO.
    B<^Z>                           # Suspendre l'exécution du programme
    [1]+  Stoppé            ./a.out
    $ B<ps H -C a.out -o 'pid tid cmd comm'>
      PID   TID CMD                         COMMAND
     5990  5990 ./a.out                     a.out
     5990  5991 ./a.out                     THREADFOO
    $ B<cat /proc/5990/task/5990/comm>
    a.out
    $ B<cat /proc/5990/task/5991/comm>
    THREADFOO

note: type: SS
en: Program source
fr: Source du programme

note: type: Plain text
en: static void *
    threadfunc(void *parm)
    {
        sleep(5);          // allow main program to set the thread name
        return NULL;
    }
fr: static void *
    threadfunc(void *parm)
    {
        sleep(5);          // permet au programme principal de définir
                           // le nom du thread
        return NULL;
    }

note: type: Plain text
en:     printf("Created a thread. Default name is: %s\en", thread_name);
        rc = pthread_setname_np(thread, (argc E<gt> 1) ? argv[1] : "THREADFOO");
        if (rc != 0)
            errExitEN(rc, "pthread_setname_np");
fr:     printf("Thread créé. Le nom par défaut est : %s\en", thread_name);
        rc = pthread_setname_np(thread, (argc E<gt> 1) ? argv[1] : "THREADFOO");
        if (rc != 0)
            errExitEN(rc, "pthread_setname_np");

note: type: Plain text
en:     rc = pthread_getname_np(thread, thread_name,
                                (argc E<gt> 2) ? atoi(argv[1]) : NAMELEN);
        if (rc != 0)
            errExitEN(rc, "pthread_getname_np");
        printf("The thread name after setting it is %s.\en", thread_name);
fr:     rc = pthread_getname_np(thread, thread_name,
                                (argc E<gt> 2) ? atoi(argv[1]) : NAMELEN);
        if (rc != 0)
            errExitEN(rc, "pthread_getname_np");
        printf("Le nom du thread après nommage est %s.\en", thread_name);

note: type: Plain text
en:     printf("Done\en");
        exit(EXIT_SUCCESS);
    }
fr:     printf("Terminé\en");
        exit(EXIT_SUCCESS);
    }

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/.
