WRITE
Section: Manuel du programmeur Linux (2) NOM SYNOPSIS DESCRIPTION VALEUR RENVOYÉE ERREURS CONFORMITÉ NOTES VOIR AUSSI TRADUCTION NOM
write - Écrire dans un descripteur de fichier.
SYNOPSIS
#include <unistd.h>
ssize_t write(int fd, const void *buf, size_t count); DESCRIPTION
write
écrit jusqu'à
count
octets dans le fichier associé au descripteur
fd
depuis le buffer pointé par
buf.
POSIX réclame qu'une lecture avec read() effectuée après le
retour d'une écriture avec write(), renvoie les nouvelles
données. Notez que tous les systèmes de fichiers ne sont pas
compatibles avec POSIX.
VALEUR RENVOYÉE
write
renvoie le nombre d'octets écrits (0 signifiant aucune écriture),
ou -1 s'il échoue,
auquel cas
errno
contient le code d'erreur.
Si count vaut zéro, et si le descripteur est associé à un
fichier normal, 0 sera renvoyé sans effets de bord. Pour un
fichier spécial, les résultats ne sont pas portables.
ERREURS
D'autres erreurs peuvent se produire suivant le type d'objet associé à fd. CONFORMITÉ
SVr4, SVID, POSIX, X/OPEN, BSD 4.3. SVr4 mentionne des conditions d'erreur
supplémentaires EDEADLK, ENOLCK, ENOLNK, ENOSR, ENXIO, EPIPE, et ERANGE.
Sous SVr4, un appel write() peut être interrompu, et renvoyer EINTR à
n'importe quel moment, pas seulement avant l'écriture des données.
NOTES
Une réussite de
write
n'offre aucune garantie que les données se trouvent sur le disque.
En fait, sur certaines implémentations erronées, elle ne garantie même pas
que l'espace suffisant a été réservé pour les données.
La seule manière d'être sûr de la réussite est d'invoquer
fsync(2)
après avoir écrit les données.
VOIR AUSSITRADUCTION
Christophe Blaess, 1996-2003.
|