Provided by: manpages-fr-dev_3.17.1-1_all bug

NOM

       io_getevents - Lire les événements 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);

       Effectuez l’édition des liens avec l’option -laio.

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

       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, voir 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 ;  voir
              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 en août 2002.

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.

       La  fonction  de  la  bibliothèque  libaio  autour  de  l’appel système
       io_getevents()  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.

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de  la  publication  3.17  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

       Cette  page  de  manuel  a  été  traduite et mise à jour par Christophe
       Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis  par
       Alain  Portal  <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

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