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

#include <linux/aio.h> long io_cancel (aio_context_t ctx_id, struct iocb *iocb, struct io_event *result);

io_cancel essaye d'annuler l'opération d'E/S asynchrone précédement soumise par l'appel io_submit. ctx_id est l'identification de contexte d'E/S asynchrone de l'opération à annuler. Si le contexte est trouvé, l'évènement sera annulé puis copié dans la zone pointée par result sans être placé dans la file des évènements terminés.

io_cancel renvoie zéro s'il réussit ou l'une des erreurs décrites ci-dessous.

EINVAL

Le contexte spécifié par ctx_id est invalide.

EFAULT

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

EAGAIN

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

ENOSYS

L'appel-système io_cancel n'est pas implémenté.

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

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

io_setup(2), io_destroy(2), io_getevents(2), io_submit(2)

Les appels d'E/S asynchrones ont été écrits par Be,jam LaHaise.

Kent Yoder.

Christophe Blaess, 1996-2003.