tee(2)                        System Calls Manual                       tee(2)

NUME
       tee - duplica con<?>inutul conductelor

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #define _GNU_SOURCE         /* Consulta<?>i feature_test_macros(7) */
       #include <fcntl.h>

       ssize_t tee(int fd_in, int fd_out, size_t len, unsigned int flags);

DESCRIERE
       tee() duplica pana la len octe<?>i de date din conducta la care se
       refera descriptorul de fi<?>ier fd_in in conducta la care se refera
       descriptorul de fi<?>ier fd_out. Nu consuma datele care sunt duplicate
       din fd_in; prin urmare, datele respective pot fi copiate de un
       splice(2) subsecvent.

       flags este o masca de bi<?>i care se compune prin combinarea prin OR
       impreuna cu zero sau mai multe dintre urmatoarele valori:

       SPLICE_F_MOVE      In prezent nu are efect pentru tee(); a se vedea
                          splice(2).

       SPLICE_F_NONBLOCK  Nu blocheaza opera<?>iile de In/Ie<?>; a se vedea
                          splice(2) pentru mai multe detalii.

       SPLICE_F_MORE      Currently has no effect for tee(), but may be
                          implemented in the future; see splice(2).

       SPLICE_F_GIFT      Neutilizat pentru tee(); a se vedea vmsplice(2).

VALOAREA RETURNATA
       La finalizarea cu succes, tee() returneaza numarul de octe<?>i care au
       fost duplica<?>i intre intrare <?>i ie<?>ire. O valoare de returnare 0
       inseamna ca nu a existat nici un transfer de date <?>i nu ar avea sens
       sa se blocheze, deoarece nu exista scriitori conecta<?>i la capatul de
       scriere al conductei la care face referire fd_in.

       In caz de eroare, tee() returneaza -1, iar errno este configurata
       pentru a indica eroarea.

ERORI-IE<?>IRE
       EAGAIN SPLICE_F_NONBLOCK a fost specificat in fanioane sau unul dintre
              descriptorii de fi<?>iere a fost marcat ca neblocant
              (O_NONBLOCK), <?>i opera<?>ia s-ar putea bloca.

       EINVAL fd_in sau fd_out nu se refera la o conducta; sau fd_in <?>i
              fd_out se refera la aceea<?>i conducta.

       ENOMEM Memorie insuficienta.

STANDARDE
       Linux.

ISTORIC
       Linux 2.6.17, glibc 2.5.

NOTE
       Din punct de vedere conceptual, tee() copiaza datele intre cele doua
       conducte. In realitate, nu are loc nicio copiere reala de date: sub
       acoperire, tee() atribuie date la ie<?>ire prin simpla preluare a unei
       referin<?>e la intrare.

EXEMPLE
       Exemplul de mai jos implementeaza un program de baza tee(1) utilizand
       apelul de sistem tee(). Iata un exemplu de utilizare a acestuia:

           $ date | ./a.out out.log | cat
           Tue Oct 28 10:06:00 CET 2014
           $ cat out.log
           Tue Oct 28 10:06:00 CET 2014

   Sursa programului
       #define _GNU_SOURCE
       #include <errno.h>
       #include <fcntl.h>
       #include <limits.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <sys/types.h>
       #include <unistd.h>

       int
       main(int argc, char *argv[])
       {
           int      fd;
           ssize_t  len, slen;

           if (argc != 2) {
               fprintf(stderr, "Utilizare: %s <fi<?>ier>\n", 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 (;;) {
               /*
                * tee ,,stdin" la ,,stdout".
                */
               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;

               /*
                * Consuma ,,stdin" prin introducerea acesteia intr-un fi<?>ier.
                */
               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);
       }

CONSULTA<?>I <?>I
       splice(2), vmsplice(2), pipe(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.8     2 mai 2024                            tee(2)