perkamon - en to fr translation catalogue (30 entries)

note: type: TH
en: 2019-10-10
fr: 10 octobre 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: sched_setaffinity, sched_getaffinity - set and get a thread's CPU affinity mask
fr: sched_setaffinity, sched_getaffinity - Définir et récupérer le masque d'affinité CPU d'un thread

note: type: Plain text
en: B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */
    B<#include E<lt>sched.hE<gt>>
fr: B<#define _GNU_SOURCE>             /* Consultez feature_test_macros(7) */
    B<#include E<lt>sched.hE<gt>>

note: type: Plain text
en: A thread's CPU affinity mask determines the set of CPUs on which it is eligible to run.  On a multiprocessor system, setting the CPU affinity mask can be used to obtain performance benefits.  For example, by dedicating one CPU to a particular thread (i.e., setting the affinity mask of that thread to specify a single CPU, and setting the affinity mask of all other threads to exclude that CPU), it is possible to ensure maximum execution speed for that thread.  Restricting a thread to run on a single CPU also avoids the performance cost caused by the cache invalidation that occurs when a thread ceases to execute on one CPU and then recommences execution on a different CPU.
fr: Le masque d'affinité CPU d'un thread détermine l'ensemble de processeurs sur lesquels il est susceptible de s'exécuter. Sur un système multiprocesseur, définir le masque d'affinité CPU permet d'obtenir une meilleure performance. Par exemple, en dédiant un CPU à un thread particulier (c'est-à-dire définir le masque d'affinité de ce thread pour indiquer un seul CPU, et définir le masque d'affinité de tous les autres threads pour exclure ce CPU), il est possible d'assurer une vitesse d'exécution maximale pour ce thread. Restreindre un processus pour qu'il ne s'exécute que sur un seul CPU réduit le coût lié à l'invalidation du cache qui se produit lorsqu'un thread cesse de s'exécuter sur un CPU puis est relancé sur un autre CPU.

note: type: Plain text
en: A CPU affinity mask is represented by the I<cpu_set_t> structure, a "CPU set", pointed to by I<mask>.  A set of macros for manipulating CPU sets is described in B<CPU_SET>(3).
fr: Un masque d'affinité CPU est représenté par la structure I<cpu_set_t>, un ensemble de CPU (« CPU set »), pointé par I<mask>. Des macros pour manipuler des ensembles de CPU sont décrites dans B<CPU_SET>(3).

note: type: Plain text
en: B<sched_setaffinity>()  sets the CPU affinity mask of the thread whose ID is I<pid> to the value specified by I<mask>.  If I<pid> is zero, then the calling thread is used.  The argument I<cpusetsize> is the length (in bytes) of the data pointed to by I<mask>.  Normally this argument would be specified as I<sizeof(cpu_set_t)>.
fr: B<sched_setaffinity>() définit le masque d'affinité CPU du thread dont l'identifiant est I<pid> à la valeur donnée par I<mask>. Si I<pid> est 0, le thread appelant est utilisé. L'argument I<cpusetsize> est la taille (en octets) de la structure pointée par I<mask>. Normalement, cet argument doit être spécifié comme I<sizeof(cpu_set_t)>.

note: type: Plain text
en: If the thread specified by I<pid> is not currently running on one of the CPUs specified in I<mask>, then that thread is migrated to one of the CPUs specified in I<mask>.
fr: Si le thread indiqué par I<pid> n'est pas actuellement en cours d'exécution sur l'un des CPU spécifiés dans I<mask>, alors ce thread est migré vers l'un des CPU spécifiés dans I<mask>.

note: type: Plain text
en: B<sched_getaffinity>()  writes the affinity mask of the thread whose ID is I<pid> into the I<cpu_set_t> structure pointed to by I<mask>.  The I<cpusetsize> argument specifies the size (in bytes) of I<mask>.  If I<pid> is zero, then the mask of the calling thread is returned.
fr: La fonction B<sched_getaffinity>() écrit dans la structure I<cpu_set_t> pointée par I<mask> le masque de préférences du thread I<pid>. L'argument I<cpusetsize> indique la taille (en octets) de I<mask>. Si I<pid> vaut zéro, le masque du thread en cours est renvoyé.

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

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: A supplied memory address was invalid.
fr: Une adresse mémoire fournie n'est pas correcte.

note: type: Plain text
en: (B<sched_getaffinity>()  and, in kernels before 2.6.9, B<sched_setaffinity>())  I<cpusetsize> is smaller than the size of the affinity mask used by the kernel.
fr: (B<sched_getaffinity>() et, pour les noyaux antérieurs à 2.6.9, B<sched_setaffinity>()) I<cpusetsize> est plus petit que la taille du masque d'affinité utilisé par le noyau.

note: type: Plain text
en: The thread whose ID is I<pid> could not be found.
fr: Le thread numéro I<pid> n'existe pas.

note: type: Plain text
en: The CPU affinity system calls were introduced in Linux kernel 2.5.8.  The system call wrappers were introduced in glibc 2.3.  Initially, the glibc interfaces included a I<cpusetsize> argument, typed as I<unsigned int>.  In glibc 2.3.3, the I<cpusetsize> argument was removed, but was then restored in glibc 2.3.4, with type I<size_t>.
fr: Les appels système d'affinité ont été introduits dans Linux 2.5.8. Les fonctions enveloppes pour ces appels système ont été introduites dans la glibc 2.3. Au départ, les interfaces de la glibc avaient un paramètre I<cpusetsize> de type I<unsigned int>. Dans glibc 2.3.3, ce paramètre a été supprimé, mais il a été réintroduit dans glibc 2.3.4, avec pour type I<size_t>.

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

note: type: Plain text
en: These system calls are Linux-specific.
fr: Ces appels système sont spécifiques à Linux.

note: type: Plain text
en: After a call to B<sched_setaffinity>(), the set of CPUs on which the thread will actually run is the intersection of the set specified in the I<mask> argument and the set of CPUs actually present on the system.  The system may further restrict the set of CPUs on which the thread runs if the "cpuset" mechanism described in B<cpuset>(7)  is being used.  These restrictions on the actual set of CPUs on which the thread will run are silently imposed by the kernel.
fr: Après un appel à B<sched_setaffinity>(), l'ensemble de CPU sur lesquels le thread s'exécutera est l'intersection de l'ensemble spécifié dans le paramètre I<mask> et l'ensemble des CPU actuellement présents sur le système. Le système peut restreindre encore plus l'ensemble des CPU sur lesquels le thread peut tourner si le mécanisme « cpuset », décrit dans B<cpuset>(7), est utilisé. Ces restrictions sur le véritable ensemble de CPU sur lesquels le thread peut tourner sont imposées sans avertissement par le noyau.

note: type: Plain text
en: B<sched>(7)  has a description of the Linux scheduling scheme.
fr: B<sched>(7) décrit les politiques d'ordonnancement sous Linux.

note: type: Plain text
en: The affinity mask is a per-thread attribute that can be adjusted independently for each of the threads in a thread group.  The value returned from a call to B<gettid>(2)  can be passed in the argument I<pid>.  Specifying I<pid> as 0 will set the attribute for the calling thread, and passing the value returned from a call to B<getpid>(2)  will set the attribute for the main thread of the thread group.  (If you are using the POSIX threads API, then use B<pthread_setaffinity_np>(3)  instead of B<sched_setaffinity>().)
fr: Le masque d'affinité est un attribut de thread, qui peut être modifié indépendamment pour chacun des threads d'un groupe de threads. La valeur renvoyée par B<gettid>(2) peut être passée dans l'argument I<pid>. Spécifier un I<pid> de 0 définira l'attribut pour le thread appelant, et une valeur égale à celle renvoyée par B<getpid>(2) définira l'attribut pour le thread principal du groupe de thread. (Si vous utilisez l'API POSIX des threads, alors utilisez B<pthread_setaffinity_np>(3) au lieu de B<sched_setaffinity>().)

note: type: Plain text
en: A child created via B<fork>(2)  inherits its parent's CPU affinity mask.  The affinity mask is preserved across an B<execve>(2).
fr: Un processus fils créé par B<fork>(2) hérite du masque d'affinité CPU de son père. Le masque d'affinité est conservé au travers d'un B<execve>(2).

note: type: SH
en: EXAMPLE
fr: EXEMPLE

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

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: TH
en: 2019-03-06
fr: 6 mars 2019

note: type: Plain text
en: On success, B<sched_setaffinity>()  and B<sched_getaffinity>()  return 0.  On error, -1 is returned, and I<errno> is set appropriately.
fr: B<sched_setaffinity>() et B<sched_getaffinity>() renvoient 0 s'ils réussissent. En cas d'échec, -1 est renvoyé, et I<errno> contient le code d'erreur.

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