.\" -*- coding: UTF-8 -*- .\" Copyright (c) 2008 Linux Foundation, written by Michael Kerrisk .\" .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PTHREAD_ATTR_SETSCOPE 3 "15 septembre 2017" Linux "Manuel du programmeur Linux" .SH NOM pthread_attr_setscope, pthread_attr_getscope \- Définir ou obtenir la contention d'un objet d'attributs de thread .SH SYNOPSIS .nf \fB#include \fP .PP \fBint pthread_attr_setscope(pthread_attr_t *\fP\fIattr\fP\fB, int \fP\fIscope\fP\fB);\fP \fBint pthread_attr_getscope(const pthread_attr_t *\fP\fIattr\fP\fB, int *\fP\fIscope\fP\fB);\fP .PP Compiler et éditer les liens avec \fI\-pthreads\fP. .fi .SH DESCRIPTION The \fBpthread_attr_setscope\fP() function sets the contention scope attribute of the thread attributes object referred to by \fIattr\fP to the value specified in \fIscope\fP. The contention scope attribute defines the set of threads against which a thread competes for resources such as the CPU. POSIX.1 specifies two possible values for \fIscope\fP: .TP \fBPTHREAD_SCOPE_SYSTEM\fP Le thread est en compétition pour les ressources avec tous les threads de tous les processus du système qui sont dans le même domaine d'allocation (un groupe composé d'un ou de plusieurs processeurs). Les threads \fBPTHREAD_SCOPE_SYSTEM\fP sont ordonnancés entre eux en fonction de leur priorité et de la politique d'ordonnancement. .TP \fBPTHREAD_SCOPE_PROCESS\fP The thread competes for resources with all other threads in the same process that were also created with the \fBPTHREAD_SCOPE_PROCESS\fP contention scope. \fBPTHREAD_SCOPE_PROCESS\fP threads are scheduled relative to other threads in the process according to their scheduling policy and priority. POSIX.1 leaves it unspecified how these threads contend with other threads in other process on the system or with other threads in the same process that were created with the \fBPTHREAD_SCOPE_SYSTEM\fP contention scope. .PP POSIX.1 requires that an implementation support at least one of these contention scopes. Linux supports \fBPTHREAD_SCOPE_SYSTEM\fP, but not \fBPTHREAD_SCOPE_PROCESS\fP. .PP Sur les systèmes qui acceptent plusieurs arbitrages de compétition, pour que la politique définie par \fBpthread_attr_setscope\fP() puisse être prise en compte lors de l'appel de \fBpthread_create\fP(3), l'appelant doit définir l'attribut d'ordonnancement hérité de l'objet \fIattr\fP au moyen de \fBpthread_attr_setinheritsched\fP(3), en lui assignant la valeur \fBPTHREAD_EXPLICIT_SCHED\fP. .PP La fonction \fBpthread_attr_getscope\fP() renvoie, dans le tampon pointé par \fIscope\fP, l'attribut contenant le mode de résolution de compétition de l'objet d'attributs de thread \fIattr\fP. .SH "VALEUR RENVOYÉE" En cas de succès, ces fonctions renvoient \fB0\fP\ ; en cas d'erreur, elles renvoient un code d'erreur non nul. .SH ERREURS \fBpthread_attr_setscope\fP() peut échouer avec les erreurs suivantes\ : .TP \fBEINVAL\fP Une valeur invalide a été spécifiée dans \fIscope\fP. .TP \fBENOTSUP\fP La valeur \fBPTHREAD_SCOPE_PROCESS\fP est spécifiée dans \fIscope\fP, or elle n'est pas supportée sous Linux. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbw24 lb lb l l l. Interface Attribut Valeur T{ \fBpthread_attr_setscope\fP(), \fBpthread_attr_getscope\fP() T} Sécurité des threads MT\-Safe .TE .SH CONFORMITÉ POSIX.1\-2001, POSIX.1\-2008. .SH NOTES La valeur \fBPTHREAD_SCOPE_SYSTEM\fP indique typiquement qu'un thread dans l'espace utilisateur est rattaché directement à une entité unique d'ordonnancement du noyau. C'est le cas sous Linux avec l'implémentation obsolète LinuxThreads, mais aussi avec l'implémentation moderne NPTL, qui sont toutes les deux des implémentations de threads 1:1. .PP POSIX.1 specifies that the default contention scope is implementation\-defined. .SH "VOIR AUSSI" .ad l .nh \fBpthread_attr_init\fP(3), \fBpthread_attr_setaffinity_np\fP(3), \fBpthread_attr_setinheritsched\fP(3), \fBpthread_attr_setschedparam\fP(3), \fBpthread_attr_setschedpolicy\fP(3), \fBpthread_create\fP(3), \fBpthreads\fP(7) .SH COLOPHON Cette page fait partie de la publication\ 5.10 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man\-pages/. .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Frédéric Hantrais . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .