Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

write

NOME

write - Scrive su un descrittore di file

SINTASSI

#include <sys/types.h>
#include <unistd.h>

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

DESCRIZIONE

write scrive fino a count byte contenuti in buf nel descrittore di file fd. POSIX richiede che una chiamata ad una read avvenuta dopo l'esecuzione di una write , sullo stesso file, restituisca i nuovi dati. Notare che non tutti i file system sono conformi a POSIX.

VALORI RESTITUITI

Se è andato tutto bene, la funzione restituisce il numero di byte scritti ( zero indica che non è stato scritto nulla ). In caso di errore viene restituito -1 ( o MAXINT se size_t è unsigned ), e errno contiene il codice di errore. Se count vale zero, e fd si riferisce ad un file regolare, la funzione può restituire zero senza che ci siano altri effetti. Per i file speciali, questo non è garantito.

ERRORI

EBADF

fd non è un descrittore di file valido, oppure il file non è aperto in lettura.

EINVAL

fd si riferisce ad un devce ( o file-system ) che non prevede la scrittura.

EFAULT

buf punta aldifuori dello spazio di indirizzamento del processo.

EPIPE

fd si riferisce ad un socket o una pipe, il cui lato-lettura è stato chiuso. Quando ciò accade, il processo che scrive, riceve un segnale SIGPIPE ; se il processo o lo intercetta, o lo blocca o lo ignora, viene generato l'errore EPIPE.

EAGAIN

è stato scelto un I/O non bloccante ( usando il flag O_NONBLOCK ) e non c'è più spazio nel buffer del socket ( o del pipe ) fd per scrivere subito.

EINTR

La chiamta è stata interrota prima della scrittura di tutti i
 dati.

ENOSPC

Il device a cui si riferisce fd non ha spazio per i dati.

EIO

Si è verificato un errore di I/O di basso livello durante la modifica dell'inode.

Possono avvenire altri errori in dipendenza dal device a cui si riferisce fd.

CONFORME AGLI STANDARD

SVr4, SVID, AT&T, POSIX, X/OPEN, BSD 4.3. SVr4 documenta errori addizionali : EDEADLK, EFBIG, ENOLCK, ENOLNK, ENOSR, ENXIO, EPIPE, o ERANGE. Sotto SVr4 una write può essere interrota in ogni momento ( codice di errore EINTR ), non solo dopo che i dati sono stati scritti.

SEE ALSO

open(2), read(2), fcntl(2), close(2), lseek(2), select(2), ioctl(2), fwrite(3).