GETPRIORITY(2)     Manuel du programmeur Linux     GETPRIORITY(2)


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'inter­
       valle  -20  à  20.  La priorite par défaut est 0, les pri­
       orité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  pro­
       cessus.  La fonction setpriority fixe la priorité des pro­
       cessus 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,



BSD                        8 Avril 1997                         1





GETPRIORITY(2)     Manuel du programmeur Linux     GETPRIORITY(2)


              mais ni son UID réel, ni son UID effectif ne corre­
              spondent à 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.










































BSD                        8 Avril 1997                         2