Man Write en français
WRITE(2)                  Manuel du programmeur Linux                 WRITE(2)



 

NOM


       write - Ecrire dans un descripteur de fichier.

 

SYNOPSIS


       #include 

       ssize_t write(int fd, const void *buf, size_t count);

 

DESCRIPTION






       write()  ecrit jusqu'a count octets dans le fichier associe au descrip-
       teur fd depuis le tampon pointe par buf.  POSIX reclame qu'une  lecture
       avec read() effectuee apres le retour d'une ecriture avec write(), ren-
       voie les nouvelles donnees. Notez que tous les systemes de fichiers  ne
       sont pas compatibles avec POSIX.

 

VALEUR RENVOYEE


       write()  renvoie  le nombre d'octets ecrits (0 signifiant aucune ecrit-
       ure), ou -1 s'il echoue, auquel cas errno contient  le  code  d'erreur.
       Si  count vaut zero, et si le descripteur est associe a un fichier nor-
       mal, 0 sera renvoye sans effets de bord. Pour un fichier  special,  les
       resultats ne sont pas portables.

 

ERREURS


       EAGAIN L'ecriture  est  non-bloquante  (attribut O_NONBLOCK du descrip-
              teur), et l'operation devrait bloquer.

       EBADF  fd n'est pas un descripteur de  fichier  valide,  ou  n'est  pas
              ouvert en ecriture.

       EFAULT buf pointe en dehors de l'espace d'adressage accessible.

       EFBIG  Tentative  d'ecrire un fichier dont la taille depasse un maximum
              dependant de l'implementation ou du processus, ou d'ecrire a une
              position qui depasse le deplacement maximal autorise.

       EINTR  L'appel  systeme a ete interrompu par un signal avant d'avoir pu
              ecrire quoique ce soit.

       EINVAL fd correspond a un objet ne permettant pas  l'ecriture ;  ou  le
              fichier a ete ouvert avec l'attribut O_DIRECT, et soit l'adresse
              specifiee dans buf, soit la valeur specifiee dans count, soit la
              tete de lecture du fichier ne sont pas correctement alignes.

       EIO    Une  erreur  d'entree-sortie bas niveau s'est produite durant la
              modification de l'i-noeud.

       ENOSPC Le peripherique correspondant a fd n'a plus de place disponible.

       EPIPE  fd  est  connecte  a  un  tube (pipe) ou une socket dont l'autre
              extremite est  fermee.  Quand  ceci  se  produit,  le  processus
              ecrivain  recoit un signal SIGPIPE .  S'il intercepte, bloque ou
              ignore ce signal, EPIPE est renvoye.

       D'autres erreurs peuvent se produire suivant le type d'objet associe  a
       fd.

 

CONFORMITE


       SVr4, BSD 4.3, POSIX.1-2001.

       Sous  SVr4,  un appel write() peut etre interrompu, et renvoyer EINTR a
       n'importe quel moment, pas seulement avant l'ecriture des donnees.

 

NOTES


       Une reussite de write() n'offre aucune  garantie  que  les  donnees  se
       trouvent  sur  le  disque.   En  fait,  sur  certaines  implementations
       erronees, elle ne garantie  meme  pas  que  l'espace  suffisant  a  ete
       reserve  pour  les  donnees.  La seule maniere d'etre sr de la reussite
       est d'invoquer fsync(2) apres avoir ecrit les donnees.

 

VOIR AUSSI


       close(2), fcntl(2), fsync(2), ioctl(2), lseek(2),  open(2),  pwrite(2),
       read(2), select(2), writev(2), fwrite(3)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le  12 octobre 1996  et  revisee  le
       14 aot 2006.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est   toujours  consultable  via  la  commande :   LANG=C man 2 write .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



Linux 2.0.32                   13 decembre 2001                       WRITE(2)