.\" -*- coding: UTF-8 -*-
.\" This manpage is Copyright (C) 2006 Jens Axboe
.\" and Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH tee 2 "3 mai 2023" "Pages du manuel de Linux 6.05.01" 
.SH NOM
tee \- Dupliquer le contenu d'un tube
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#define _GNU_SOURCE\fP         /* Consultez feature_test_macros(7) */
\fB#include <fcntl.h>\fP
.PP
\fBssize_t tee(int \fP\fIfd_in\fP\fB, int \fP\fIfd_out\fP\fB, size_t \fP\fIlen\fP\fB, unsigned int \fP\fIflags\fP\fB);\fP
.fi
.\" Return type was long before glibc 2.7
.SH DESCRIPTION
.\" Example programs http://brick.kernel.dk/snaps
.\"
.\"
.\" add a "tee(in, out1, out2)" system call that duplicates the pages
.\" (again, incrementing their reference count, not copying the data) from
.\" one pipe to two other pipes.
\fBtee\fP() duplique jusqu'à \fIlen\fP octets de données du tube auquel le
descripteur de fichier \fIfd_in\fP fait référence vers le tube référencé par
\fIfd_out\fP. Il ne supprime pas les données qui sont dupliquées depuis
\fIfd_in\fP\ ; ces données peuvent donc être copiées par un futur appel à
\fBsplice\fP(2).
.PP
L'argument \fIflags\fP est un masque de bits constitué par un \fIOU\fP binaire
entre une ou plusieurs des valeurs suivantes\ :
.TP  1.9i
\fBSPLICE_F_MOVE\fP
N'a pas d'effet pour \fBtee\fP() actuellement\ ; consultez \fBsplice\fP(2).
.TP 
\fBSPLICE_F_NONBLOCK\fP
Ne pas bloquer pendant les entrées\-sorties\ ; consultez \fBsplice\fP(2) pour
plus de détails.
.TP 
\fBSPLICE_F_MORE\fP
N'a pas d'effet pour \fBtee\fP() actuellement, mais pourrait être implémenté un
jour\ ; consultez \fBsplice\fP(2).
.TP 
\fBSPLICE_F_GIFT\fP
Inutilisé pour \fBtee\fP()\ ; consultez \fBvmsplice\fP(2).
.SH "VALEUR RENVOYÉE"
En cas de succès, \fBtee\fP() renvoie le nombre d'octets dupliqués entre les
tubes d'entrée et de sortie. La valeur de retour \fB0\fP signifie qu'il n'y
avait aucune donnée à transférer, et que bloquer n'aurait pas de sens car il
n'y a aucun écrivain connecté à l'extrémité d'écriture du tube référencé par
\fIfd_in\fP.
.PP
En cas d'erreur, \fBtee\fP() renvoie \fB\-1\fP et \fIerrno\fP est défini pour préciser
l'erreur.
.SH ERREURS
.TP 
\fBEAGAIN\fP
\fBSPLICE_F_NONBLOCK\fP était indiqué dans \fIflags\fP ou un des descripteurs de
fichier a été marqué comme non bloquant (\fBO_NONBLOCK\fP), et l'opération
pourrait bloquer.
.TP 
\fBEINVAL\fP
\fIfd_in\fP ou \fIfd_out\fP ne correspond pas à un tube\ ; ou bien \fIfd_in\fP et
\fIfd_out\fP font référence au même tube.
.TP 
\fBENOMEM\fP
Plus assez de mémoire.
.SH STANDARDS
Linux.
.SH HISTORIQUE
Linux 2.6.17, glibc 2.5.
.SH NOTES
Conceptuellement, \fBtee\fP() copie les données entre deux tubes. En fait, il
n'y a pas de réelle copie de données\ : sous cette apparence, \fBtee\fP()
attache les données au tube de sortie en prenant simplement une référence
sur les données en entrée.
.SH EXEMPLES
L'exemple suivant implémente une version basique du programme \fBtee\fP(1) en
utilisant l'appel système \fBtee\fP(). Voici un exemple de cette utilisation\ :
.PP
.in +4n
.EX
$ \fBdate | ./a.out out.log | cat\fP
Tue Oct 28 10:06:00 CET 2014
$ \fBcat out.log\fP
Tue Oct 28 10:06:00 CET 2014
.EE
.in
.SS "Source du programme"
.\" SRC BEGIN (tee.c)
\&
.EX
#define _GNU_SOURCE
#include <errno.h>
#include <fcntl.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
\&
int
main(int argc, char *argv[])
{
    int      fd;
    ssize_t  len, slen;
\&
    if (argc != 2) {
        fprintf(stderr, "Utilisation\ : %s <fichier>\en", argv[0]);
        exit(EXIT_FAILURE);
    }
\&
    fd = open(argv[1], O_WRONLY | O_CREAT | O_TRUNC, 0644);
    if (fd == \-1) {
        perror("open");
        exit(EXIT_FAILURE);
    }
\&
    for (;;) {
        /*
         * Dupliquer l'entrée standard dans la sortie standard.
         */
        len = tee(STDIN_FILENO, STDOUT_FILENO,
                  INT_MAX, SPLICE_F_NONBLOCK);
        if (len < 0) {
            if (errno == EAGAIN)
                continue;
            perror("tee");
            exit(EXIT_FAILURE);
        }
        if (len == 0)
            break;
\&
        /*
         * Consommer l'entrée standard en la raccordant à un fichier.
         */
        while (len > 0) {
            slen = splice(STDIN_FILENO, NULL, fd, NULL,
                          len, SPLICE_F_MOVE);
            if (slen < 0) {
                perror("splice");
                exit(EXIT_FAILURE);
            }
            len \-= slen;
        }
    }
\&
    close(fd);
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "VOIR AUSSI"
\fBsplice\fP(2), \fBvmsplice\fP(2), \fBpipe\fP(7)
.PP
.SH 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>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .