NOM

       vmsplice - Raccorder des pages utilisateur à un tube ou à partir d'un tube

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #define _GNU_SOURCE         /* Consultez feature_test_macros(7) */
       #include <fcntl.h>

       ssize_t vmsplice(int fd, const struct iovec *iov,
                        size_t nr_segs, unsigned int flags);

DESCRIPTION

       Si  fd  est  ouvert  en  écriture,  l'appel  système  vmsplice() projette les nr_segs segments de mémoire
       utilisateur décrits par iov dans un tube. Si fd est ouvert en lecture, l'appel système vmsplice() remplit
       des segments de mémoire utilisateur décrits par iov à partir d'un tube. Le descripteur de fichier fd doit
       faire référence à un tube.

       Le pointeur iov pointe vers un tableau de structures iovec comme décrit dans iovec(3type).

       L'argument flags est un masque binaire constitué par un OU binaire entre une  ou  plusieurs  des  valeurs
       suivantes :

       SPLICE_F_MOVE
              Non utilisé pour vmsplice() ; consultez splice(2).

       SPLICE_F_NONBLOCK
              Ne pas bloquer pendant les entrées-sorties ; consultez splice(2) pour plus de détails.

       SPLICE_F_MORE
              N'a  pas  d'effet  pour vmsplice() actuellement, mais pourrait être implémenté un jour ; consultez
              splice(2).

       SPLICE_F_GIFT
              Les pages utilisateur sont offertes au noyau. L'application ne pourra plus jamais  modifier  cette
              mémoire,  sans  quoi  le  cache  de  pages  et  les  données  stockées  sur disque pourraient être
              différentes. Offrir des pages au noyau signifie qu'un futur appel  à  SPLICE_F_MOVE  de  splice(2)
              peut  effectivement  déplacer  les  pages ;  si  ce paramètre n'est pas spécifié, un futur appel à
              SPLICE_F_MOVE de  splice(2)  doit  copier  les  pages.  Les  données  doivent  par  ailleurs  être
              correctement alignées sur des frontières de pages, que ce soit en mémoire ou en taille.

VALEUR RENVOYÉE

       S'il  réussit, vmsplice() renvoie le nombre d'octets transférés dans le tube. En cas d'erreur, vmsplice()
       renvoie -1 et errno est défini pour préciser l'erreur.

ERREURS

       EAGAIN SPLICE_F_NONBLOCK était indiqué dans flags, et l'opération pourrait bloquer.

       EBADF  fd n'est pas valable ou ne correspond pas à un tube.

       EINVAL nr_segs est supérieur à IOV_MAX, ou bien  la  mémoire  n'est  pas  alignée  si  SPLICE_F_GIFT  est
              spécifié.

       ENOMEM Plus assez de mémoire.

VERSIONS

       L'appel  système  vmsplice()  est  apparu  dans Linux 2.6.17, la prise en charge de la bibliothèque a été
       ajoutée dans la glibc 2.5.

STANDARDS

       Cet appel système est spécifique à Linux.

NOTES

       vmsplice() suit les conventions des autres fonctions vectorielles de type read/write  quant  aux  limites
       sur  le  nombre  de  segments  qui peuvent être passés. Cette limite est IOV_MAX définie dans <limits.h>.
       Actuellement, cette limite est 1024.

       vmsplice() prend en charge réellement le raccord véritable uniquement à partir de la mémoire  utilisateur
       vers  un  tube.  En direction inverse, il copie vraiment seulement les données dans l'espace utilisateur.
       Mais cela fait une interface agréable et symétrique qui permet  de  construire  sur  vmsplice()  avec  de
       l'espace pour une amélioration ultérieure de performance.

VOIR AUSSI

       splice(2), tee(2), pipe(7)

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> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter à la  GNU  General  Public  License
       version 3   ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   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⟩.