NAZWA¶

tee - powiela zawartość potoku

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

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

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

OPIS¶

tee() powiela maksymalnie len bajtów danych z potoku, do którego odnosi się deskryptor pliku fd_in, do potoku, do którego odnosi się deskryptor pliku fd_out. Nie konsumuje danych duplikowanych z fd_in, zatem dane te można skopiować kolejnym wywołaniem splice(2).

flags jest maską bitową tworzoną jako suma logiczna (OR) zera lub większej liczby następujących wartości:

SPLICE_F_MOVE

Obecnie nie wpływa na tee(); zob. splice(2).

SPLICE_F_NONBLOCK

Nie blokuje wejścia/wyjścia; więcej informacji w podręczniku splice(2).

SPLICE_F_MORE

Obecnie nie wpływa na tee(), lecz może być zaimplementowane w przyszłości; zob. splice(2).

SPLICE_F_GIFT

Nieużywane w tee(); zob. vmsplice(2).

WARTOŚĆ ZWRACANA¶

Po pomyślnym zakończeniu, tee() zwraca liczbę zduplikowanych między wejściem i wyjściem bajtów. Zwracana wartość 0 oznacza, że nie wystąpiły dane do przetransferowania, zatem blokowanie nie miało sensu, ponieważ do końca do zapisu potoku, do którego odnosi się fd_in, nie było zapisujących.

W razie wystąpienia błędu tee zwraca -1 i ustawia errno, wskazując błąd.

BŁĘDY¶

EAGAIN

We flags podano SPLICE_F_NONBLOCK lub jeden z deskryptorów plików oznaczono jako nieblokujący (O_NONBLOCK), natomiast operacja spowodowałaby blokowanie.

EINVAL

fd_in lub fd_out nie odnoszą się do potoku; albo fd_in i fd_out odnoszą się do tego samego potoku.

ENOMEM

Brak pamięci.

WERSJE¶

Wywołanie systemowe tee() pojawiło się w Linuksie 2.6.17; obsługę w bibliotecę dodano w glibc 2.5.

STANDARDY¶

To wywołanie systemowe jest typowo linuksowe.

UWAGI¶

Kopiowanie danych pomiędzy potokami przez tee() jest tylko konceptem. Tak naprawdę nie dochodzi do kopiowania: za kulisami tee() przypisuje dane z wyjścia, jedynie przez przechwycenie odniesienia do wejścia.

PRZYKŁADY¶

Poniższy przykład implementuje prosty program tee(1) za pomocą wywołania systemowego tee(). Oto przykład jego użycia:

$ date | ./a.out out.log | cat
wto, 28 paź 2014, 10:06:00 CET
$ cat out.log
wto, 28 paź 2014, 10:06:00 CET

#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, "Użycie: %s <plik>\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 (;;) {


        /*


         * Użyj tee ze standardowego wejścia do st. wyjścia.


         */


        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;


        /*


         * Skonsumuj st. wejście dokonując splice do pliku.


         */


        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);
}

ZOBACZ TAKŻE¶

splice(2), vmsplice(2), pipe(7)

TŁUMACZENIE¶

Tłumaczenie niniejszej strony podręcznika: Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.