NOME¶

readv, writev, preadv, pwritev, preadv2, pwritev2 - leggono o scrivono dati in buffer multipli

LIBRARY¶

Standard C library (libc, -lc)

SINTASSI¶

#include <sys/uio.h>

ssize_t readv(int fd, const struct iovec *iov, int iovcnt);
ssize_t writev(int fd, const struct iovec *iov, int iovcnt);

ssize_t preadv(int fd, const struct iovec *iov, int iovcnt,
                off_t offset);
ssize_t pwritev(int fd, const struct iovec *iov, int iovcnt,
                off_t offset);

ssize_t preadv2(int fd, const struct iovec *iov, int iovcnt,
                off_t offset, int flags);
ssize_t pwritev2(int fd, const struct iovec *iov, int iovcnt,
                off_t offset, int flags);

preadv(), pwritev():

    A partire da glibc 2.19:


        _DEFAULT_SOURCE


    glibc 2.19 e precedenti:


        _BSD_SOURCE

DESCRIZIONE¶

La chiamata di sistema readv() legge i buffer iovcnt dal file associato al descrittore di file fd nei buffer descritti da iov ("scatter input").

La chiamata di sistema writev() scrive i buffer di dati iovcnt descritti da iov nel file associato al descrittore di file fd ("gather output").

The pointer iov points to an array of iovec structures, described in iovec(3type).

La chiamata di sistema readv() funziona esattamente come read(2) tranne per il fatto che i buffer multipli sono riempiti.

La chiamata di sistema writev() funziona esattamente come write(2) tranne per il fatto che i buffer multipli sono svuotati.

I buffer sono elaborati in ordine di array. Ciò significa che readv() riempie completamente iov[0] prima di procedere a iov[1], e così via. (Se ci sono dati insufficienti allora non tutti i buffer puntati da iov possono essere riempiti) Similarmente, writev() estrae l'intero contenuto di iov[0] prima di procedere a iov[1], e così via.

I trasferimenti di dati eseguiti da readv() e writev() sono atomici: il dato scritto da writev() è scritto come un blocco singolo che non è mescolato con output provenienti da scritture in altri processi ; analogamente, readv() è garantito che legga un blocco contiguo di dati dal file, indipendentemente dalle operazioni di lettura eseguite in altri thread o processi che hanno descrittori di file che fanno riferimento alla stessa descrizione di file aperto (si veda open(2)).

VALORE RESTITUITO¶

In caso di successo, readv(), preadv() e preadv2() restituiscono il numero di byte letti; writev(), pwritev() e pwritev2() restituiscono il numero di byte scritti.

Si noti che non è un errore per una chiamata andata a buon fine trasferire meno byte di quelli richiesti (si veda read(2) e write(2)).

In caso di errore viene restituito -1 , e errno è impostato per indicare l'errore.

ERRORI¶

Gli errori sono gli stessi di read(2) e write(2). Per di più, preadv(), preadv2(), pwritev(), e pwritev2() possono anche non andare a buon fine per le stesse ragioni di lseek(2). Inoltre sono definiti i seguenti errori:

EINVAL

La somma dei valori iov_len supera un valore ssize_t.

EINVAL

Il vettore conteggio, iovcnt, è minore di zero o maggiore del massimo permesso.

EOPNOTSUPP

Un flag sconosciuto è specificato in flags.

VERSIONI¶

preadv() e pwritev() sono apparse per la prima volta in Linux 2.6.30; il supporto alla libreria è stato aggiunto in glibc 2.10.

preadv2() e pwritev2() sono apparse per la prima volta in Linux 4.6. Il supporto alla libreria è stato aggiunto in glibc 2.26.

STANDARDS¶

readv(), writev(): POSIX.1-2001, POSIX.1-2008, 4.4BSD (queste chiamate di sistema sono apparse per la prima volta in 4.2BSD).

preadv(), pwritev(): non standard, però presente anche nei sistemi BSD moderni.

preadv2(), pwritev2(): Estensione Linux non standard.

NOTE¶

POSIX.1 permette un'implementazione per porre un limite al numero di elementi che possono essere passati in iov. Un'implementazione può pubblicizzare i suoi limiti definendo IOV_MAX in <limits.h> o in run time attraverso il valore restituito da sysconf(_SC_IOV_MAX). Sui sistemi Linux moderni, il limite è 1024, prima di Linux 2.0 questo limite era 16.

BUG¶

Linux 5.9 and Linux 5.10 have a bug where preadv2() with the RWF_NOWAIT flag may return 0 even when not at end of file.

ESEMPI¶

Il seguente codice di esempio mostra l'uso di writev():

char          *str0 = "hello ";
char          *str1 = "world\n";
ssize_t       nwritten;
struct iovec  iov[2];
iov[0].iov_base = str0;
iov[0].iov_len = strlen(str0);
iov[1].iov_base = str1;
iov[1].iov_len = strlen(str1);
nwritten = writev(STDOUT_FILENO, iov, 2);

VEDERE ANCHE¶

pread(2), read(2), write(2)

TRADUZIONE¶

La traduzione italiana di questa pagina di manuale è stata creata da Giulio Daprelà <giulio@pluto.it> e Marco Curreli <marcocurreli@tiscali.it>

Questa traduzione è documentazione libera; leggere la GNU General Public License Versione 3 o successiva per le condizioni di copyright. Non ci assumiamo alcuna responsabilità.

Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a pluto-ildp@lists.pluto.it.