table of contents
AIO_READ(3) | Manuel du programmeur Linux | AIO_READ(3) |
NOM¶
aio_read - Lecture asynchrone
SYNOPSIS¶
#include <aio.h>
int aio_read(struct aiocb *aiocbp);
Effectuez l'édition des liens avec l'option -lrt.
DESCRIPTION¶
La fonction aio_read() met en file d'attente les requêtes d'E/S décrites par le tampon pointé par aiocb. Cette fonction est la version asynchrone de read(2). Les arguments de l'appel
read(fd, buf, count)
correspondent (dans l'ordre) au membre aio_fildes, aio_buf et aio_nbytes de la structure pointée par aiocbp. Consultez aio(7) pour une description de la structure aiocb.
La donnée est lue en commençant au décalage absolu du fichier aiocbp->aio_offset, quelle que soit la position actuelle du pointeur sur le fichier. Après cet appel, la valeur de la position courante du pointeur du fichier est indéfinie.
« Asynchrone » signifie que cet appel renvoie aussitôt que la requête a été mise dans la file d'attente ; la lecture peut être ou ne pas être achevée lorsque l'appel renvoie. On peut tester cet achèvement en utilisant aio_error(3). La valeur de retour d'une opération d'E/S complétée peut être obtenue avec aio_return(3). La notification asynchrone de la fin de l'E/S peut être obtenue en définissant aiocbp->aio_sigevent de façon appropriée. Consultez sigevent(7) pour plus de détails.
Si _POSIX_PRIORITIZED_IO est définie et si le fichier le supporte, l'opération asynchrone est soumise à une priorité égale à celle du processus appelant moins aiocbp->aio_reqprio.
Le membre aiocbp->aio_lio_opcode est ignoré.
Aucune donnée n'est lue dans un fichier régulier au-delà de son décalage maximum.
VALEUR RENVOYÉE¶
En cas de réussite, 0 est renvoyé. En cas d'erreur, la requête n'est pas mise dans la file d'attente, -1 est renvoyé et errno est définie en conséquence. Si une erreur est détectée plus tard, elle sera signalée via aio_return(3) (état de retour -1) et aio_error(3) (état d'erreur : tout ce qu'on veut, récupéré dans errno, comme EBADF).
ERREURS¶
- EAGAIN
- Ressources insuffisantes.
- EBADF
- aio_fildes n'est pas un descripteur de fichier valable ouvert en lecture.
- EINVAL
- Une ou plusieurs valeurs parmi aio_offset, aio_reqprio ou aio_nbytes ne sont pas valables.
- ENOSYS
- aio_read() n'est pas implémenté.
- EOVERFLOW
- Le fichier est un fichier régulier, nous avons commencé la lecture avant la fin de fichier et voulons au moins un octet, mais la position de départ a dépassé le décalage maximum du fichier.
VERSIONS¶
La fonction aio_read() est disponible depuis la glibc 2.1.
CONFORMITɶ
POSIX.1-2001, POSIX.1-2008.
NOTES¶
C'est une bonne idée de mettre à zéro le bloc de contrôle avant de l'utiliser. Ce bloc de contrôle ne doit pas être modifié pendant l'opération de lecture. Il ne faut pas accéder à la zone tampon à lire pendant l'opération, sinon des résultats indéfinis peuvent survenir. Les zones mémoires atteintes doivent rester valables.
Des opérations d'E/S simultanées spécifiant la même structure aiocb produisent des résultats indéfinis.
EXEMPLE¶
Consultez aio(7).
VOIR AUSSI¶
aio_cancel(3), aio_error(3), aio_fsync(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7)
COLOPHON¶
Cette page fait partie de la publication 3.52 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¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.
Alain Portal <http://manpagesfr.free.fr/> (2004-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».
8 mai 2012 |