Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
aio_read - Lecture asynchrone
SYNOPSIS
#include <aio.h>
int aio_read(struct aiocb *aiocbp);
Effectuez l'edition des liens avec l'option -lrt.
DESCRIPTION
La fonction aio_read() sollicite un << n = read(fd, buf, count) >>
asynchrone avec fd, buf, count donnes respectivement par
aiocbp->aio_fildes, aiocbp->aio_buf et aiocbp->aio_nbytes. L'etat de
retour n peut etre recupere a la fin avec aio_return(3).
La donnee est lue en commencant au decalage absolu du fichier
aiocbp->aio_offset, quelle que soit la position actuelle du pointeur
sur le fichier. Apres cette requete, la valeur de la position courante
du pointeur du fichier est indefinie.
<< Asynchrone >> signifie que cet appel s'acheve aussitot que la
requete a ete mise dans la file d'attente ; la lecture peut etre ou ne
pas etre achevee lorsque l'appel s'acheve. On peut tester cet
achevement en utilisant aio_error(3).
Si _POSIX_PRIORITIZED_IO est definie et si le fichier le supporte,
l'operation asynchrone est soumise a une priorite egale a celle du
processus appelant moins aiocbp->aio_reqprio.
Le membre aiocbp->aio_lio_opcode est ignore.
Aucune donnee n'est lue dans un fichier regulier au-dela de son
decalage maximum.
VALEUR RENVOY'EE
En cas de reussite, 0 est renvoye. En cas d'erreur, la requete n'est
pas mise dans la file d'attente, -1 est renvoye et errno est definie en
consequence. Si une erreur est detectee plus tard, elle sera signalee
via aio_return(3) (etat de retour -1) et aio_error(3) (etat d'erreur :
tout ce qu'on veut, recupere 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,
aio_nbytes ne sont pas valables.
ENOSYS La fonction n'est pas implementee sur ce systeme.
EOVERFLOW
Le fichier est un fichier regulier, nous avons commence la
lecture avant la fin de fichier et voulons au moins un octet,
mais la position de depart a depasse le decalage maximum du
fichier.
CONFORMIT'E
POSIX.1-2001.
NOTES
C'est une bonne idee de mettre a zero le bloc de controle avant de
l'utiliser. Ce bloc de controle ne doit pas etre modifie pendant
l'operation de lecture. Il ne faut pas acceder a la zone tampon a lire
pendant l'operation, sinon des resultats indefinis peuvent survenir.
Les zones memoires atteintes doivent rester valides.
VOIR AUSSI
aio_cancel(3), aio_error(3), aio_fsync(3), aio_return(3),
aio_suspend(3), aio_write(3)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Alain Portal <URL:http://manpagesfr.free.fr/> (2004-2006). Florentin
Duneau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
14 novembre 2003 AIO_READ(3)