NOM
aio_cancel - Annuler une requête d’E/S asynchrone en cours
SYNOPSIS
#include <aio.h>
int aio_cancel(int fd, struct aiocb *aiocbp);
Effectuez l’édition des liens avec l’option -lrt.
La fonction aio_cancel() tente d’annuler les requêtes d’E/S asynchrones
en cours du descripteur de fichier fd. Si aiocbp est NULL, toutes les
requêtes sont annulées. Sinon, seule la requête décrite par le bloc de
contrôle pointé par aiocbp est annulée.
Une notification asynchrone normale survient pour les requêtes
annulées. L’état de retour de la requête est défini à -1 et l’état de
l’erreur de la requête est défini à ECANCELED. Le bloc de contrôle des
requêtes qui n’ont pas été annulées n’est pas modifié.
Si aiocbp n’est pas NULL et si fd diffère du descripteur de fichier
pour lequel l’opération asynchrone a été initiée, les résultats sont
imprévisibles.
Les opérations qui peuvent être annulées dépendent de l’implémentation.
VALEUR RENVOYÉE
Cette fonction renvoie AIO_CANCELED si toutes les requêtes ont été
annulées avec succès. Elle renvoie AIO_NOTCANCELED si au moins une des
requêtes spécifiées n’a pas été annulée parce qu’elle était en cours.
Dans ce cas, il est possible de vérifier individuellement l’état des
requêtes en utilisant aio_error(3). Cette fonction renvoie AIO_ALLDONE
si toutes les requêtes étaient déjà achevées avant cet appel. Lorsque
des erreurs apparaissent, -1 est renvoyé et errno est définie en
conséquence.
ERREURS
EBADF fd n’est pas un descripteur de fichier valable.
CONFORMITÉ
POSIX.1-2001.
VOIR AUSSI
aio_error(3), aio_fsync(3), aio_read(3), aio_return(3), aio_suspend(3),
aio_write(3)
COLOPHON
Cette page fait partie de la publication 3.23 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
Cette page de manuel a été traduite et mise à jour par Alain Portal
<aportal AT univ-montp2 DOT fr> entre 2004 et 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
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> ».
14 novembre 2003