io_getevents

Autres langues

Langue: fr

Version: 21 février 2003 (mandriva - 01/05/08)

Section: 2 (Appels système)

NOM

io_getevents - Lire les évenements d'E/S asynchrones terminés

SYNOPSIS

 #include <linux/time.h>
 #include <libaio.h>
 
 int io_getevents(aio_context_t ctx_id, long min_nr, long nr,
                  struct io_event *events, struct timespec *timeout);
 

DESCRIPTION

io_getevents() essaye de lire au moins min_nr et au plus nr événements de la liste de terminaison du contexte d'entrées-sorties asynchrones ctx_id. timeout indique une durée maximale d'attente pour les événements. S'il est NULL, l'attente dure jusqu'à avoir au moins min_nr événements. Notez que timeout est relatif et sera mis à jour si l'opération bloque et qu'il n'est pas NULL.

VALEUR RENVOYÉE

S'il réussit, io_getevents() renvoie le nombre d'événements lus, zéro s'il y en a moins de min_nr et si le délai timeout a expiré ; s'il échoue, il renvoie l'une des erreurs décrites dans ERREURS.

ERREURS

EINVAL
ctx_id est invalide, min_nr ou nr est incorrect.
EFAULT
events ou timeout est un pointeur invalide.
ENOSYS
io_getevents() n'est pas implémenté sur cette architecture.

VERSIONS

Les appels système d'entrées-sorties asynchrones sont apparus dans Linux 2.5 en août 2002.

CONFORMITÉ

io_getevents() est spécifique à Linux et ne doit pas être utilisé dans des programmes conçus pour être portables.

VOIR AUSSI

io_setup(2), io_cancel(2), io_destroy(2), io_submit(2)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 juillet 2003 et révisée le 26 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 io_getevents ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.