PTHREAD_ATTR_SETSCHEDPARAM

Manuel du programmeur Linux (3)
21 avril 2014

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(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_setscheduler(2) 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), sched_setscheduler(2), pthread_attr_init(3), pthread_attr_setinheritsched(3), pthread_attr_setschedpolicy(3), pthread_create(3), pthread_setschedparam(3), pthread_setschedprio(3), pthreads(7)

COLOPHON

Cette page fait partie de la publication 3.66 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> ».

Index

Multithreading (voir pthreads(7))

This document was created by man2html, using the manual pages.
Time: 21:52:40 GMT, July 12, 2014