.de Sh " Subsection .if t .Sp .ne 5

$1

.. .de Sp " Vertical space (when we can't use .PP) .if t .5v .if n .. .de Ip " List item .ie
(.$>=3 .ne $3 .el .ne 3
[/col][/row][/table]

Nom

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

Résumé

.ad l .hy 0 #include <linux/aio.h> .HP 16 long io_cancel (aio_context_t ctx_id, struct iocb *iocb, struct io_event *result); .ad .hy

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


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

Notes


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

Auteur

Kent Yoder.

Traduction

Christophe Blaess, 1996-2003.