Fonctions du
système (section 2) getpriority
Nom
getpriority, setpriority - Lire / écrire la priorité d'ordonnancement du processus.Synopsis
#include <sys/time.h>#include <sys/resource.h>
int getpriority(int which, int who);
int setpriority(int which, int who, int prio);
Description
La priorité d'ordonnancement du processus, du groupe de processus ou de l'utilisateur, comme précisé dans which et who est lue avec getpriority et fixée avec setpriority. Which doit être l'un des éléments PRIO_PROCESS, PRIO_PGRP, ou PRIO_USER, et who est interprété en fonction de which (un ID de processus pour PRIO_PROCESS, un ID de groupe de processus pour PRIO_PGRP, et un ID d'utilisateur pour PRIO_USER).Une valeur nulle pour who indique le processus, groupe ou utilisateur courant. Prio est une valeur dans l'intervalle -20 à 20. La priorite par défaut est 0, les priorités les plus faibles indiquant un ordonnancement le plus favorable.
La fonction getpriority retourne la plus haute priorité (la plus basse valeur numérique) dont à bénéficié le processus. La fonction setpriority fixe la priorité des processus indiqués à la valeur fournie. Seul le Super-User peut diminuer la valeur numérique de la priorité (favoriser le processus).
Valeur Renvoyée
Comme getpriority peut tout à fait renvoyer la valeur -1, il faut effacer la variable externe errno avant l'appel afin de vérifier si une valeur -1 indique une erreur ou une priorité légitime.setpriority renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.
Erreurs
- ESRCH
- Aucun processus ne correspond aux valeurs de which et who.
- EINVAL
- Which n'était ni PRIO_PROCESS, ni PRIO_PGRP, ni PRIO_USER.
De plus setpriority échouera pour les erreurs suivantes :
- EPERM
- Un processus correspond bien aux valeurs indiquées, mais ni son UID réel, ni son UID effectif ne correspondent à ceux de l'appelant.
- EACCES
- Tentative de favoriser un processus sans être Super-User.
Conformité
SVCr4, BSD 4.4 (Cette fonction est apparue dans BSD 4.2).Voir Aussi
nice(1) , fork(2) , renice(8)
Traduction
Christophe Blaess, 1997.