Sous-routine setpri
Objectif
Définit une priorité de planification de processus sur une valeur constante.
Bibliothèque
Bibliothèque C standard (libc.a)
Syntaxe
Descriptif
La sous-routine setpri définit la priorité de planification de toutes les unités d'exécution d'un processus comme étant une constante. Les règles de planification de toutes les unités d'exécution sont remplacées par SCHED_RR. Une valeur de processus et une utilisation de l'unité centrale ne peuvent plus être utilisées pour déterminer une priorité de planification de processus. Seuls les processus disposant de droits d'accès utilisateur root peuvent définir une priorité de planification de processus sur une constante.
Paramètres
| Article | Descriptif |
|---|---|
| ProcessID | Indique l'ID de processus. Si cette valeur est 0, la priorité de planification du processus en cours est définie sur une constante. |
| Priority | Indique la priorité de planification du processus. Une valeur de nombre inférieure désigne une priorité de planification plus élevée. Le paramètre Priorité doit être compris dans la plage PRIORITY_MIN < = Priorité < PRIORITY_MAX. (Voir le fichier sys/sched.h .) |
Valeurs renvoyées
Une fois l'opération terminée, la sous-routine setpri renvoie l'ancienne priorité de planification du processus qui vient d'être modifiée. Dans le cas contraire, la valeur -1 est renvoyée et la variable globale errno est définie pour indiquer l'erreur.
Codes d'erreur
La sous-routine setpri échoue si une ou plusieurs des conditions suivantes sont remplies:
| Article | Descriptif |
|---|---|
| EINVAL | La priorité spécifiée par le paramètre Priorité est en dehors de la plage des priorités acceptables. |
| EPERM | Le processus exécutant l'appel de sous-routine setpri ne dispose pas des droits utilisateur root. |
| ESRCH | Aucun processus correspondant à celui spécifié par le paramètre ProcessID n'a été trouvé. |