TEE

名前

書式

#define _GNU_SOURCE
#include <fcntl.h>

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

説明

flags は一連の修飾フラグであり、 splice(2) や vmsplice(2) と共通の名前である。

SPLICE_F_MOVE

現在のところ tee() では何の効果もない。 splice(2) 参照。

SPLICE_F_NONBLOCK

入出力時に停止 (block) しない。 詳細は splice(2) 参照。

SPLICE_F_MORE

現在のところ tee() では何の効果もないが、将来的には実装される可能性がある。 splice(2) 参照。

SPLICE_F_GIFT

tee() では未使用。 vmsplice(2) 参照。

返り値

エラーの場合、 tee() は -1 を返し、 errno にエラーを示す値を設定する。  

エラー

EINVAL

fd_in と fd_out のどちらかがパイプを参照していない。もしくは fd_in と fd_out が同じパイプを参照している。

ENOMEM

メモリ不足。

バージョン

準拠

注意

例

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

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

    assert(argc == 2);

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

    do {
        /*
         * 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);
        } else
            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");
                break;
            }
            len -= slen;
        }
    } while (1);

    close(fd);
    exit(EXIT_SUCCESS);
}

関連項目

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

例

関連項目