Man Getpriority en français
GETPRIORITY(2)            Manuel du programmeur Linux           GETPRIORITY(2)



 

NOM


       getpriority,  setpriority - Lire/ecrire la priorite d'ordonnancement du
       processus.

 

SYNOPSIS


       #include 
       #include 

       int getpriority(int which, int who);
       int setpriority(int which, int who, int prio);

 

DESCRIPTION






       La priorite d'ordonnancement du processus, du groupe de processus ou de
       l'utilisateur,  comme  precise dans which et who est lue avec getprior-
       ity() et fixee avec setpriority().

       La valeur de which doit etre l'une parmi  PRIO_PROCESS,  PRIO_PGRP,  ou
       PRIO_USER, et who est interprete en fonction de which (un ID de proces-
       sus 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
       (respectivement) le processus  appelant,  le  groupe  de  processus  de
       l'appelant  ou  l'UID  reel du processus appelant.  Prio est une valeur
       dans l'intervalle -20 a 19 (voir les Notes plus bas).  La priorite  par
       defaut  est  0, les priorites les plus faibles indiquant un ordonnance-
       ment le plus favorable.

       La fonction getpriority() renvoie la plus haute priorite (la plus basse
       valeur numerique) dont a beneficie l'un des processus indique. La fonc-
       tion setpriority() fixe la priorite des processus indiques a la  valeur
       fournie.   Seul  le super-utilisateur peut diminuer la valeur numerique
       de la priorite.

 

VALEUR RENVOYEE


       Comme getpriority() peut tout a fait renvoyer la  valeur  -1,  il  faut
       effacer la variable externe errno avant l'appel afin de verifier si une
       valeur -1 indique une erreur ou une priorite legitime.  L'appel setpri-
       ority() renvoie 0 s'il reussit, ou -1 s'il echoue et remplit errno.

 

ERREURS


       EINVAL which n'etait ni PRIO_PROCESS, ni PRIO_PGRP, ni PRIO_USER.

       ESRCH  Aucun  processus  ne  correspond  aux  valeurs  de  which et who
              indiquees.

       De plus, setpriority() peut echouer pour les erreurs suivantes :

       EPERM  Un processus correspond bien  aux  valeurs  indiquees,  mais  ni
              l'UID reel, ni l'UID effectif de l'appelant ne lui correspondent
              et il n'est pas privilegie (sous Linux, il n'a pas  la  capacite
              CAP_SYS_NICE).  Voir la section NOTES plus loin.

       EACCES L'appelant  a essaye de diminuer la priorite d'un processus mais
              il n'avait pas le privilege necessaire (sous Linux : n'avait pas
              la capacite CAP_SYS_NICE).  Depuis Linux 2.6.12, cette erreur ne
              survient que si l'appelant tente de configurer  la  priorite  du
              processus  a  une  valeur  hors  de l'intervalle de la limite de
              ressources logicielles RLIMIT_NICE  du  processus  cible ;  voir
              getrlimit(2) pour plus de details.

 

NOTES


       Un  fils  cree  avec  fork(2)  herite de la valeur de courtoisie de son
       pere.  La valeur de courtoisie est preservee a travers un execve(2).

       Les details concernant la condition d'erreur EPERM  dependent  du  sys-
       teme.   La  description  ci-dessus concerne ce que dit POSIX.1-2001, et
       qui semble etre suivi par tous les systemes de  type  Systeme  V.   Les
       noyaux  Linux  avant  la  version  2.6.12 demandaient que l'UID reel ou
       effectif de l'appelant correspondent a l'UID reel du processus who  (et
       non  pas  a  son UID effectif).  Linux 2.6.12 et suivants demandent que
       l'UID effectif de l'appelant corresponde a l'UID reel  ou  effectif  du
       processus  who.  Tous les systemes de type BSD (SunOS 4.1.3, Ultrix 4.2
       BSD 4.3, FreeBSD 4.3, OpenBSD-2.5...) se comportent de la meme  maniere
       que Linux 2.6.12 et suivants.

       Le  veritable  intervalle  des  priorites varie suivant les versions du
       noyau.  Sur les  systemes  Linux  anterieurs  au  1.3.36,  l'intervalle
       s'etendait  de -infini a 15. Depuis le 1.3.43, il correspond a -20..19.
       Dans le noyau, les valeurs de priorite sont  actuellement  representees
       en  utilisant  l'intervalle  40..1  correspondant  (puisque les nombres
       negatifs sont des codes d'erreur) et ces valeurs sont utilisees par les
       appels systeme setpriority() et getpriority().  Les fonctions enveloppe
       de la bibliotheque pour ces  appels  systeme  gerent  les  translations
       entre  les  representations noyau et espace utilisateur de la valeur de
       priorite suivant la formule prio_user = 20 - prio_noyau.

       L'inclusion   n'est  plus  obligatoire,  mais  ameliore  la
       portabilite.   (En  fait,   definit la structure rusage
       qui contient des champs de type struct timeval defini ).

 

CONFORMITE


       SVr4, BSD 4.4 (Cette fonction est apparue dans BSD 4.2),  POSIX.1-2001.

 

VOIR AUSSI


       nice(1), fork(2), capabilities(7), renice(8)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le  11 octobre 1996  et  revisee  le
       14 aot 2006.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours consultable via la commande :  LANG=C man 2 getpriority .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



LDP                            20 septembre 2002                GETPRIORITY(2)