AIO_CANCEL
Section : Manuel du programmeur Linux (
3)
Mise à jour de la version anglaise : 14 novembre 2003
Index
Menu principal
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);
Utilisez
-lrt
à l'édition de liens.
DESCRIPTION
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.
Autrement, 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
lorsque toutes les requêtes étaient déjà achevées avant cet appel.
Lorsque des erreurs apparaissent, -1 est renvoyé et
errno
est contient le code d'erreur.
ERREURS
- EBADF
-
fd
n'est pas un descripteur de fichier valide.
CONFORMITÉ
POSIX.1-2001.
VOIR AUSSI
aio_error(3),
aio_fsync(3),
aio_read(3),
aio_return(3),
aio_suspend(3),
aio_write(3)
TRADUCTION
Ce document est une traduction réalisée par Alain Portal
<aportal AT univ-montp2 DOT fr> le 6 juillet 2005
et révisée le 17 juillet 2008.
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=C man 3 aio_cancel ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008