Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       io_cancel - Annuler une operation d'entree-sortie asynchrone en attente

SYNOPSIS

       #include <libaio.h>

       int io_cancel(aio_context_t ctx_id, struct iocb *iocb,
                     struct io_event *result);

       Effectuez l'edition des liens avec l'option -laio.

DESCRIPTION

       io_cancel()  essaye d'annuler l'operation d'E/S asynchrone precedemment
       soumise  par  l'appel  io_submit(2).  ctx_id  est  l'identification  de
       contexte  d'E/S asynchrone de l'operation a annuler. Si le contexte est
       trouve, l'evenement sera annule puis copie dans  la  zone  pointee  par
       result sans etre place dans la file des evenements termines.

VALEUR RENVOY'EE

       io_cancel()  renvoie  zero  s'il reussit. Pour les valeurs de retour en
       cas d'echec, consultez la section NOTES.

ERREURS

       EAGAIN L'operation iocb n'a pas ete annulee.

       EFAULT L'une des structures de donnees pointe sur une zone invalide.

       EINVAL Le contexte indique par ctx_id est invalide.

       ENOSYS L'appel systeme  io_cancel()  n'est  pas  implemente  sur  cette
              architecture.

VERSIONS

       Les  appels  systeme  d'entrees-sorties  asynchrones  sont apparus dans
       Linux 2.5 en aout 2002.

CONFORMIT'E

       io_cancel() est specifique a Linux et ne doit pas etre utilise dans des
       programmes destines a etre portables.

NOTES

       La glibc ne fournit pas de fonction autour de cet appel systeme.

       La  fonction  de  la  bibliotheque  libaio  autour  de  l'appel systeme
       io_cancel() ne suit pas les conventions classiques de la bibliotheque C
       concernant  l'indication  des  erreurs :  en  cas d'erreur, la fonction
       renvoie un nombre negatif (la valeur  negative  de  l'une  des  valeurs
       indiquees dans la section ERREURS). Si l'appel systeme est invoque 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_destroy(2), io_getevents(2), io_setup(2), io_submit(2)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

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

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

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.