Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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)