PTHREAD_ATTR_SETSCHEDPARAM(3)

NOM
pthread_attr_setschedparam, pthread_attr_getschedparam - Définir ou obtenir les paramètres d'ordonnancement d'un objet d'attributs de thread

SYNOPSIS
#include <pthread.h>
int pthread_attr_setschedparam(pthread_attr_t *attr,
                               const struct sched_param *param);
int pthread_attr_getschedparam(const pthread_attr_t *attr,
                               struct sched_param *param);

Compilez et effectuez l'édition des liens avec l'option -pthread.

DESCRIPTION
La fonction pthread_attr_setschedparam() définit l'attribut des paramètres d'ordonnancement de l'objet d'attributs de thread auquel attr fait référence à la valeur indiquée par param. Ces attributs déterminent les paramètres d'ordonnancement d'un thread créé en utilisant l'objet d'attributs de thread attr. La fonction pthread_attr_getschedparam() renvoie, dans le tampon pointé par param, l'attribut contenant les paramètres d'ordonnancement de l'objet d'attributs de thread auquel attr fait référence. Les paramètres d'ordonnancement sont gérés dans la structure suivante :
struct sched_param {
    int sched_priority;     /* Priorité d'ordonnancement */
};
Comme on peut le voir, un seul paramètre d'ordonnancement est supporté. Veuillez consulter sched(7) pour plus de détails sur les valeurs possibles des priorités d'ordonnancement en fonction de chaque politique d'ordonnancement. Pour que les paramètres définis par pthread_attr_setschedparam() puissent être pris en compte lors de l'appel de pthread_create(3), l'appelant doit définir l'attribut d'ordonnancement hérité de l'objet attr au moyen de pthread_attr_setinheritsched(3), en lui assignant la valeur PTHREAD_EXPLICIT_SCHED.

VALEUR RENVOYÉE
En cas de réussite, ces fonctions renvoient 0 ; en cas d'erreur elles renvoient un numéro d'erreur non nul.

ERREURS
POSIX.1 documente des erreurs EINVAL et ENOTSUP pour pthread_attr_setschedparam(). Sous Linux, ces fonctions réussissent toujours (mais les applications portables et à l'épreuve du temps devraient néanmoins prendre en charge une possible valeur de retour).

ATTRIBUTS

  Multithreading (voir pthreads(7))
Les fonctions pthread_attr_setschedparam() et pthread_attr_getschedparam() sont sûres dans un contexte multithread.

CONFORMITÉ
POSIX.1-2001.

NOTES
Veuillez consulter pthread_attr_setschedpolicy(3) pour avoir la liste des politiques d'ordonnancement des threads supportées sous Linux.

EXEMPLE
Consultez pthread_setschedparam(3).

VOIR AUSSI
sched_get_priority_min(2), pthread_attr_init(3), pthread_attr_setinheritsched(3), pthread_attr_setschedpolicy(3), pthread_create(3), pthread_setschedparam(3), pthread_setschedprio(3), pthreads(7), sched(7)

COLOPHON
Cette page fait partie de la publication 3.70 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».