NOME¶

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

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").

Il puntatore iov punta a un array di strutture iovec, definite in <sys/uio.h> come:

struct iovec {


    void  *iov_base;    /* Indirizzo di partenza */


    size_t iov_len;     /* Numero di byte da trasferire */
};

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 (tuttavia si veda pipe(7) per un'eccezione); 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 appropriatamente.

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.

CONFORME A¶

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.

ESEMPI¶

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

char *str0 = "hello ";
char *str1 = "world\n";
struct iovec iov[2];
ssize_t nwritten;
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)

COLOPHON¶

Questa pagina fa parte del rilascio 5.10 del progetto Linux man-pages. Una descrizione del progetto, le istruzioni per la segnalazione degli errori, e l'ultima versione di questa pagina si trovano su https://www.kernel.org/doc/man-pages/.

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.