Man page 2 : ioprio_set

ioprio_get, ioprio_set - Lire et écrire la classe et la priorité d'ordonnancement des E/S

int ioprio_get(int which, int who);
int ioprio_set(int which, int who, int ioprio);

Note : il n'y a pas de fonctions d'enrobage pour ces appels système. Consultez les NOTES.

Les appels système ioprio_get() et ioprio_set() respectivement lisent et écrivent la classe et la priorité d'ordonnancement des entrées et sorties pour un ou plusieurs processus. Les arguments which et who identifient le(s) thread(s) sur lesquels les appels système agissent. L'argument which détermine comment who est interprété, et prend l'une des valeurs suivantes :

• IOPRIO_WHO_PROCESS
      who est l'identifiant d'un processus ou d'un thread. Si who vaut 0, alors l'action s'applique au thread appelant.
• IOPRIO_WHO_PGRP
      who est l'identifiant d'un groupe de processus et se réfère à tous les membres de ce groupe. Si who vaut 0, alors l'action s'applique au groupe de processus auquel l'appelant appartient.
• IOPRIO_WHO_USER who est un UID identifiant tous les processus dont l'UID réel correspond.

Si which vaut IOPRIO_WHO_PGRP ou IOPRIO_WHO_USER à l'appel de ioprio_get(), et si plus d'un processus correspond à who, la priorité renvoyée sera la plus grande des priorités des processus correspondants. Une priorité est dite plus grande qu'une autre si elle appartient à une classe de priorité supérieure (IOPRIO_CLASS_RT est la classe la plus haute ; IOPRIO_CLASS_IDLE est la plus basse) ou si elle appartient à la même classe mais a un niveau de priorité plus élevé (donc un numéro de priorité plus faible). L'argument ioprio donné à ioprio_set() est un masque de bits indiquant la classe et la priorité à donner au(x) processus cible(s). Les macros suivantes servent à créer et à tester les valeurs ioprio :

• IOPRIO_PRIO_VALUE(class, data)
      Étant données une classe d'ordonnancement (class) et une priorité (data), cette macro combine les deux valeurs pour créer une valeur ioprio, qui est renvoyée comme résultat.
• IOPRIO_PRIO_CLASS(mask)
      À partir de mask (une valeur ioprio) cette macro renvoie sa classe d'E/S, c'est-à-dire une valeur parmi IOPRIO_CLASS_RT, IOPRIO_CLASS_BE et IOPRIO_CLASS_IDLE.
• IOPRIO_PRIO_DATA(mask)
      Étant donné mask (une valeur ioprio), renvoie la priorité (data) correspondante.

Consultez la section NOTES pour plus d'informations sur les classes et priorités d'ordonnancement. Les priorités d'E/S sont gérées pour les lectures et pour les écritures synchrones (O_DIRECT, O_SYNC). Les priorités d'E/S ne sont pas gérées pour les écritures asynchrones parce qu'elles sont lancées hors du contexte du programme touchant la mémoire, ce qui fait que les priorités spécifiques à chaque programme ne s'appliquent pas.

Lorsqu'il réussit, ioprio_get() renvoie la valeur ioprio du processus dont la priorité d'E/S est la plus grande parmi les processus correspondant aux critères indiqués par which et who. En cas d'erreur, -1 est renvoyé, et errno contient le code d'erreur.

S'il réussit, ioprio_set() renvoie zéro. En cas d'erreur, il renvoie -1 et remplit errno avec la valeur d'erreur.

• EINVAL
      which ou ioprio est invalide. Consultez la section NOTES pour les classes et priorités d'ordonnancement disponibles pour ioprio.
• EPERM
      Le processus appelant n'a pas les privilèges nécessaires pour attribuer cette priorité ioprio au(x) processus indiqué(s). Consultez la section NOTES pour plus d'informations sur les privilèges nécessaires pour ioprio_set().
• ESRCH
      Aucun processus ne correspond aux critères indiqués par which et who.

Ces appels système sont disponibles sous Linux depuis le noyau 2.6.13.

Ces appels système sont spécifiques à Linux.

La glibc ne fournit pas de fonction d'enrobage autour de ces appels système ; appelez-les avec syscall(2). Plusieurs processus ou threads peuvent partager un contexte d'entrées-sorties. Cela est le cas lorsque clone(2) a été appelé avec l'attribut CLONE_IO. Cependant, par défaut, les threads distincts d'un processus ne partagent pas le même contexte d'entrées-sorties. Cela signifie que si vous voulez changer la priorité d'entrées-sortie de tous les threads d'un processus, il peut être nécessaire d'appeler ioprio_set() sur chacun de ces threads. L'identifiant du thread nécessaire pour cette opération est renvoyé par gettid(2) ou clone(2). Ces appels système n'ont d'effet que lorsqu'ils sont utilisés avec un ordonnanceur d'E/S qui gère les priorités d'E/S. Sous Linux 2.6.17, l'ordonnanceur « Completely Fair Queuing » (CFQ) est le seul ordonnanceur d'E/S de ce type.

8.1. Choisir un ordonnanceur d'E/S ▲

$ cat /sys/block/hda/queue/scheduler
noop anticipatory deadline [cfq]

$ su
Password:
# echo cfq > /sys/block/hda/queue/scheduler

8.2. L'ordonnanceur d'E/S « Completely Fair Queuing » (CFQ) ▲

8.3. Permissions nécessaires pour définir les priorités d'E/S ▲

Glibc ne fournit pas encore de fichier d'en(hytête définissant les prototypes de fonctions et les macros décrits dans cette page. Les définitions se trouvent dans linux/ioprio.h.

ionice(1), getpriority(2), open(2), capabilities(7) Documentation/block/ioprio.txt dans les sources du noyau Linux

Cette page fait partie de la publication 3.52 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».