Provided by: manpages-fr-dev_3.57d1p1-1_all bug

NOM

       io_cancel - Annuler une opération d'entrée-sortie asynchrone en attente

SYNOPSIS

       #include <linux/aio_abi.h>          /* Définit les types nécessaires */

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

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

DESCRIPTION

       L'appel système io_cancel() essaye d'annuler  l'opération  d'E/S  asynchrone  précédemment
       soumise  par  l'appel  io_submit(2).  L'argument  iocb  décrit  l'opération  à  annuler et
       l'argument ctx_id est le contexte d'E/S asynchrone auquel l'opération a  été  soumise.  Si
       l'opération  est  correctement  annulée,  l'événement  sera copié dans la zone pointée par
       result sans être placé dans la file des événements terminés.

VALEUR RENVOYÉE

       io_cancel() renvoie zéro s'il  réussit.  Pour  les  valeurs  de  retour  en  cas  d'échec,
       consultez la section NOTES.

ERREURS

       EAGAIN L'opération iocb n'a pas été annulée.

       EFAULT L'une des structures de données pointe sur une zone invalide.

       EINVAL Le contexte indiqué par ctx_id est invalide.

       ENOSYS L'appel système io_cancel() 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_cancel()  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_cancel() 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.

VOIR AUSSI

       io_destroy(2), io_getevents(2), io_setup(2), io_submit(2), aio(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> ».