io_cancel

Autres langues

Langue: fr

Autres versions - même langue

Version: 21 février 2003 (fedora - 16/08/07)

Section: 2 (Appels système)

Sommaire

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édemment 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ème 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 Benjamin LaHaise.

AUTEUR

Kent Yoder.

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 juillet 2003 et révisée le 7 juillet 2006.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=en man 2 io_cancel ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.