> Linux Reviews > man >

tee

tee.2.man

1. tee.2.man

Manpage of TEE

TEE

Section: Руководство программиста Linux (2)
Updated: 2009-09-15
Index Return to Main Contents

ИМЯ

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

ОБЗОР

#define _GNU_SOURCE
#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 представляет собой набор флагов-модификаторов, которые используются также в splice(2) и vmsplice(2):

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 устанавливается в соответствующее значение.

ОШИБКИ

EINVAL: Значение fd_in или fd_out не указывает на канал; fd_in и fd_out указывают на один и тот же канал.
ENOMEM: Не хватает памяти.

ВЕРСИИ

Системный вызов tee() впервые появился в Linux 2.6.17.

СООТВЕТСТВИЕ СТАНДАРТАМ

Данный вызов есть только в Linux.

ЗАМЕЧАНИЯ

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

ПРИМЕР

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


#define _GNU_SOURCE
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <errno.h>
#include <limits.h>

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

    if (argc != 2) {
        fprintf(stderr, "Usage: %s <file>
", argv[0]);
        exit(EXIT_FAILURE);
    }

    fd = open(argv[1], O_WRONLY | O_CREAT | O_TRUNC, 0644);
    if (fd == -1) {
        perror("open");
        exit(EXIT_FAILURE);
    }

    do {
        /*
         * перекладывать из stdin в stdout.
         */
        len = tee(STDIN_FILENO, STDOUT_FILENO,
                  INT_MAX, SPLICE_F_NONBLOCK);

        if (len < 0) {
            if (errno == EAGAIN)
                continue;
            perror("tee");
            exit(EXIT_FAILURE);
        } else
            if (len == 0)
                break;

        /*
         * Поглотить stdin, объединяя данные в файле.
         */
        while (len > 0) {
            slen = splice(STDIN_FILENO, NULL, fd, NULL,
                          len, SPLICE_F_MOVE);
            if (slen < 0) {
                perror("splice");
                break;
            }
            len -= slen;
        }
    } while (1);

    close(fd);
    exit(EXIT_SUCCESS);
}

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

splice(2), vmsplice(2), feature_test_macros(7)

This document was created by man2html using the manual pages.
Time: 17:42:04 GMT, May 11, 2012