man io_cancel (Appels systèmes) - Annuler une opération d'entrée/sortie asynchrone en attente.

NOM

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

SYNOPSIS

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

DESCRIPTION

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.

VALEUR RENVOYÉE

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

ERREURS

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

HISTORIQUE

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

CONFORMITÉ

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

VOIR AUSSI

NOTES

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

AUTEUR

Kent Yoder.

TRADUCTION

Christophe Blaess, 1996-2003.