НАИМЕНОВАНИЕ

       tee - повторяет содержимое канала

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

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

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

ОПИСАНИЕ

       Вызов  tee()  повторяет  до  len  байт данных из канала, на который указывает файловый дескриптор fd_in в
       канал, на который указывает файловый дескриптор fd_out. Он не потребляет  данные,  копируемые  из  fd_in,
       поэтому эти данные можно копировать последующим вызовом splice(2).

       Аргумент flags представляет собой битовую маску, которая составляется логическим сложением (OR) следующих
       значений:

       SPLICE_F_MOVE      В данный момент никак не влияет при указании в tee(); см. splice(2).

       SPLICE_F_NONBLOCK  Не блокировать ввод-вывод; подробности в splice(2).

       SPLICE_F_MORE      В  данный  момент  никак  не влияет при указании в tee(), но это может измениться; см.
                          splice(2).

       SPLICE_F_GIFT      Не используется для tee(); см. vmsplice(2).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       При успешном выполнении, tee() возвращает количество байт, которые были  повторены  из  ввода  в  выводе.
       Возвращаемое  значение 0 означает, что нет данных для передачи, и блокировка не имеет смысла, так как нет
       процессов-писателей, подключённых к каналу для записи, на который указывает fd_in.

       В случае ошибки tee() возвращает -1, а errno устанавливается в соответствующее значение.

ОШИБКИ

       EAGAIN В flags указан SPLICE_F_NONBLOCK или один из файловых дескрипторов был помечен  как  неблокирующий
              (O_NONBLOCK), и операция вызвала бы блокировку.

       EINVAL Значение fd_in или fd_out не указывает на канал; fd_in и fd_out указывают на один и тот же канал.

       ENOMEM Не хватает памяти.

СТАНДАРТЫ

       Linux.

ИСТОРИЯ

       Linux 2.6.17, glibc 2.5.

ПРИМЕЧАНИЯ

       Концептуально,  tee()  копирует  данные между двумя каналами. В реальности, данные не копируются на самом
       деле: внутри, tee() назначает данные на вывод просто схватывая ссылку из ввода.

ПРИМЕРЫ

       В примере далее показана простая реализация программы tee(1) с помощью системного  вызова  tee().  Пример
       использования:

           $ 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

   Исходный код программы

       #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, "Usage: %s <file>\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 to 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;

               /*
                * Consume stdin by splicing it to a file.
                */
               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);
       }

СМОТРИТЕ ТАКЖЕ

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

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства  разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>,
       Dmitry   Bolkhovskikh   <d20052005@yandex.ru>,   Yuri   Kozlov    <yuray@komyakino.ru>,    Иван    Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот  перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html  версии  3  или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если  вы  обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом
       разработчику(ам)  по  его(их)  адресу(ам)  электронной  почты  или  по   адресу   списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                  15 июня 2024 г.                                          tee(2)