NOM

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

SYNOPSIS

       #include <linux/aio_abi.h>         /* Définit les types nécessaires */
       #include <linux/time.h>            /* Définit « struct timespec » */

       int io_getevents(aio_context_t ctx_id, long min_nr, long nr,
                        struct io_event *events, struct timespec *timeout);

       Remarque :  il  n'existe  pas  de  fonction  glibc autour de cet appel système ; consultez
       NOTES.

DESCRIPTION

       L'appel système io_getevents() essaye de lire de min_nr à nr événements  de  la  file  des
       événements  terminés  du contexte d'entrées-sorties asynchrones ctx_id. L'argument 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. Remarquez que timeout est relatif.

VALEUR RENVOYÉE

       io_getevents()  renvoie  le nombre d'événements lus, zéro s'il n'y en a aucun, et moins de
       min_nr si le délai timeout a expiré. Pour les valeurs de retour en cas d'échec,  consultez
       la section NOTES.

ERREURS

       EFAULT events ou timeout est un pointeur invalide.

       EINVAL ctx_id est invalide, min_nr ou nr est incorrect.

       EINTR  L'appel a été interrompu par un gestionnaire de signal ; consultez signal(7).

       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.

CONFORMITÉ

       io_getevents()  est  spécifique  à  Linux  et ne doit pas être utilisé dans des programmes
       destinés à être portables.

NOTES

       La glibc ne fournit pas de fonction autour de cet appel système. Vous pourriez  l'invoquer
       en  utilisant  syscall(2),  mais vous préférerez sans doute utiliser la fonction enveloppe
       io_getevents() fournie par libaio.

       Remarquez que la fonction enveloppe libaio  utilise  un  autre  type  (io_context_t)  pour
       l'argument  ctx_id. Remarquez également que l'enveloppe libaio ne suit pas les conventions
       classiques de la bibliothèque C concernant l'indication des erreurs : en cas d'erreur,  la
       fonction renvoie un nombre négatif (la valeur négative de l'une des valeurs indiquées dans
       la section ERREURS). Si l'appel système est invoqué avec syscall(2), la valeur  de  retour
       suit  les  conventions classiques pour indiquer l'erreur : -1 avec errno contenant le code
       (positif) de l'erreur.

BOGUES

       Un ctx_id invalide peut provoquer une erreur de segmentation au lieu de générer une erreur
       EINVAL.

VOIR AUSSI

       io_cancel(2), io_destroy(2), io_setup(2), io_submit(2), aio(7), time(7)

COLOPHON

       Cette  page  fait partie de la publication 3.57 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/.

TRADUCTION

       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/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

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