NOM¶

readv, writev, preadv, pwritev, preadv2, pwritev2 - Lire ou écrire des données dans plusieurs tampons

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#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() :

    Depuis la glibc 2.19 :


        _DEFAULT_SOURCE


    glibc 2.19 et antérieures :


        _BSD_SOURCE

DESCRIPTION¶

L'appel système readv() lit iovcnt tampons depuis le fichier associé au descripteur de fichier fd dans les tampons décrits par iov.(« scatter input »)

L'appel système writev() écrit au plus iovcnt tampons de données décrits par iov dans le fichier associé au descripteur fd (« gather output »).

Le pointeur iov pointe vers un tableau de structures iovec, définies dans iovec(3type)

L'appel système readv() travaille comme read(2) sauf que plusieurs tampons sont remplis.

L'appel système writev() travaille comme write(2) sauf que plusieurs tampons sont écrits.

Les tampons sont considérés dans l'ordre du tableau. Cela signifie que readv() remplit iov[0] complètement avant d'en arriver à iov[1], et ainsi de suite. (S'il n'y a pas assez de données, tous les tampons pointés par iov ne seront pas forcément remplis.) De même, writev() écrit tout le contenu de iov[0] avant de considérer iov[1] et ainsi de suite.

Les transferts de données effectués par readv() et writev() sont atomiques : les données écrites par writev() sont écrites d'un bloc qui n'est pas interrompu par des écritures venant d'autres processus ; de façon similaire, readv() a la garantie de lire un bloc contigu de données depuis le fichier, quelles que soient les opérations de lecture effectuées par d'autres threads ou processus qui ont des descripteurs de fichier correspondant à la même description de fichier ouvert (consultez open(2)).

VALEUR RENVOYÉE¶

S'ils réussissent, readv(), preadv() et preadv2() renvoient le nombre d'octets lus ; writev, pwritev() et pwritev2() renvoient le nombre d'octets écrits.

Remarquez que le fait de transférer moins d'octets que deux demandés (voir read(2) et write(2)) ne constitue pas une erreur empêchant le succès de l'appel.

En cas d'erreur, la valeur de retour est -1 et errno est définie pour préciser l'erreur.

ERREURS¶

Les erreurs sont comme celles indiquées pour read(2) et write(2). En outre, preadv(), preadv2() et pwritev() peuvent aussi échouer pour les mêmes raisons que lseek(2). De plus, les erreurs suivantes peuvent survenir :

EINVAL

La somme des valeurs iov_len déborde une valeur ssize_t.

EINVAL

Le nombre de vecteurs iovcnt est inférieur à zéro ou supérieur au maximum autorisé.

EOPNOTSUPP

Un drapeau inconnu est indiqué dans flags.

VERSIONS¶

preadv() et pwritev() sont apparus dans Linux 2.6.30 ; la glibc les gère depuis la version 2.10.

preadv() et pwritev() sont apparus dans Linux 4.6. La prise en charge a été ajoutée à la glibc 2.26.

STANDARDS¶

readv(), writev() : POSIX.1-2001, POSIX.1-2008, 4.4BSD (ces appels système sont apparus pour la première fois dans 4.2BSD).

preadv(), pwritev() : non standard, mais sont aussi présents sur les BSD modernes.

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

NOTES¶

POSIX.1 autorise une implémentation à poser une limite au nombre d'éléments qui peuvent être placés dans iov. Une implémentation peut indiquer cette limite en définissant IOV_MAX dans <limits.h> ou pendant l'exécution à l'aide d'un code de retour issu de sysconf(_SC_IOV_MAX). Sur les systèmes Linux modernes, la limite est de 1024. À l'époque de Linux 2.0, la limite était de 16.

BOGUES¶

Linux 5.9 et Linux 5.10 contiennent un bogue dans lequel preadv2() avec l'attribut RWF_NOWAIT peut renvoyer 0 même quand la fin du fichier n'est pas atteinte.

EXEMPLES¶

Le segment de code suivant donne un exemple d'utilisation de 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);

VOIR AUSSI¶

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

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Frédéric Hantrais <fhantrais@gmail.com> et Jean-Philippe MENGUAL <jpmengual@debian.org>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.