Sous-routine pthread_getschedparam

Editer en ligne

Objectif

Renvoie les attributs schedpolicy et schedparam en cours d'une unité d'exécution.

Bibliothèque

Bibliothèque d'unités d'exécution (libpthreads.a)

Syntaxe

#include <pthread.h>
#include <sys/sched.h>

int pthread_getschedparam ( thread,  schedpolicy,  schedparam)
pthread_t thread;
int *schedpolicy;
struct sched_param *schedparam;

Descriptif

La sous-routine pthread_getschedparam renvoie les attributs schedpolicy et schedparam en cours de l'unité d'exécution thread. L'attribut schedpolicy spécifie la règle de planification d'une unité d'exécution. Il peut avoir l'une des valeurs suivantes:

Tableau 1. Valeurs de règle de planification
Article Descriptif
SCHED_FIFO Indique la planification de la première entrée et de la première sortie.
SCHED_RR Indique la planification de la permutation circulaire.
SCHED_OTHER Indique la règle de planification du système d'exploitation par défaut. Il s'agit de la valeur par défaut.

L'attribut schedparam spécifie les paramètres de planification d'une unité d'exécution créée avec cet objet d'attribut. La zone sched_priority de la structure sched_param contient la priorité de l'unité d'exécution. Il s'agit d'une valeur entière.

Remarque: le fichier d'en-tête pthread.h doit être le premier fichier inclus de chaque fichier source à l'aide de la bibliothèque d'unités d'exécution. Sinon, l'indicateur de compilation -D_THREAD_SAFE doit être utilisé ou le compilateur cc_r doit être utilisé. Dans ce cas, l'indicateur est automatiquement défini.

L'implémentation de cette sous-routine dépend de l'option POSIX de planification des priorités. L'option POSIX de planification des priorités est implémentée dans le système d'exploitation.

Paramètres

Tableau 2. Paramètres
Article Descriptif
thread Indique l'unité d'exécution cible.
schedpolicy Indique l'emplacement de stockage de la valeur d'attribut schedpolicy.
schedparam Indique où la valeur de l'attribut schedparam sera stockée.

Valeurs renvoyées

Une fois l'opération terminée, la valeur en cours des attributs schedpolicy et schedparam est renvoyée via les paramètres schedpolicy et schedparam , et 0 est renvoyé. Sinon, un code d'erreur est renvoyé.

Codes d'erreur

La sous-routine pthread_getschedparam échoue si la condition suivante est vraie:

Tableau 3. Codes d'erreur
Article Descriptif
ESRCH L'unité d'exécution thread n'existe pas.