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

NOM

       aio_write - Ecriture asynchrone

SYNOPSIS

       #include <aio.h>

       int aio_write(struct aiocb *aiocbp);

       Effectuez l'edition des liens avec l'option -lrt.

DESCRIPTION

       La  fonction  aio_write()  sollicite un << n = write(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 l'achevement en utilisant aio_return(3).

       Si O_APPEND n'est pas defini, la donnee est  ecrite  en  commencant  au
       decalage  absolu  du  fichier  aiocbp->aio_offset,  quelle  que soit la
       position actuelle dans le fichier. Si O_APPEND est  defini,  la  donnee
       est  ecrite  a  la fin du fichier. Apres cette requete, la valeur de la
       position << courante >> dans le fichier est indefinie.

       << Asynchrone >> signifie  que  cet  appel  s'acheve  aussitot  que  la
       requete  ait  ete mise dans la file d'attente ; l'ecriture 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  ecrite  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
              ecriture.

       EFBIG  Le fichier est un fichier regulier, nous voulons ecrire au moins
              un octet, mais la position de depart est egale,  ou  au-dela  du
              decalage maximum du fichier.

       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.

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 d'ecriture. Il ne faut pas  acceder  a  la  zone  tampon  a
       ecrire  pendant  l'operation  ou  bien  des resultats indefinis peuvent
       survenir. Les zones memoires atteintes doivent rester valables.

VOIR AUSSI

       aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3),  aio_return(3),
       aio_suspend(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_WRITE(3)