tee(2)

NAVN
tee - duplikere datakanalindhold

BIBLIOTEK
C-standardbibliotek (libc, -lc)

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

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

BESKRIVELSE
tee() duplikerer op til size databyte fra datakanalen refereret til af fildeskriptoren fd_in til datakanalen refereret til af fildeskriptoren fd_out. Forbruger ikke dataene der er duplikeret fra fd_in; dataene kan derfor efterfølgende kopieres af en splice(2).

flag er en bit-maske der er sammensat af at ORing'e sammen nul eller flere af de følgende værdier:

SPLICE_F_MOVE
    Har i øjeblikket ingen effekt for tee(); se splice(2).

SPLICE_F_NONBLOCK
    Bloker ikke en I/O; se splice(2) for yderligere detaljer.

SPLICE_F_MORE
    Har i øjeblikket ingen effekt for tee(), men kan blive implementeret i fremtiden; se splice(2).

SPLICE_F_GIFT
    Ubrugt for tee(); se vmsplice(2).

RETURVÆRDI
Ved succesfuld fuldførelse returnerer tee() antallet af byte, der blev duplikeret mellem inddata og uddata. En returværdi på 0 betyder at der ingen data var at overføre, og det ville give mening at blokere, da der ingen skrivere er forbundet til skriveslutningen af datakanalen refereret til af fd_in.

Ved fejl returnerer tee() -1 og errno angives for at indikere fejlen.

FEJL

EAGAIN
    SPLICE_F_NONBLOCK var angivet i flag eller en af fildeskriptorerne er blevet markeret som ikkeblokerende (O_NONBLOCK), og operationen ville blokere.

EINVAL
    fd_in eller fd_out refererer ikke til en datakanal; eller fd_in og fd_out refererer til den samme datakanal.

ENOMEM
    Ikke nok hukommelse.

STANDARDER
Linux.

HISTORIK
Linux 2.6.17, glibc 2.5.

NOTER
Konceptuelt kopierer tee() dataene mellem de to datakanaler. I virkeligheden sker der dog ingen reel datakopiering: under overfladen tildeler tee() data til resultatet ved bare at fange en reference til dataene.

EKSEMPLER
Eksemplet nedenfor implementerer et grundlæggende tee(1)-program via systemkaldet tee(). Her er et eksempel på dets brug:

    $ 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

  Programkilde
    #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  size, ssize;

        if (argc != 2) {
            fprintf(stderr, "Brug: %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-standardind til standardud.
             */
            size = tee(STDIN_FILENO, STDOUT_FILENO,
                      INT_MAX, SPLICE_F_NONBLOCK);
            if (size < 0) {
                if (errno == EAGAIN)
                    continue;
                perror("tee");
                exit(EXIT_FAILURE);
            }
            if (size == 0)
                break;

            /*
             * Forbrug standardind ved at samle det i en fil.
             */
            while (size > 0) {
                ssize = splice(STDIN_FILENO, NULL, fd, NULL,
                              size, SPLICE_F_MOVE);
                if (ssize < 0) {
                    perror("splice");
                    exit(EXIT_FAILURE);
                }
                size -= ssize;
            }
        }

        close(fd);
        exit(EXIT_SUCCESS);
    }

SE OGSÅ
splice(2), vmsplice(2), pipe(7)

OVERSÆTTELSE
Oversættere af denne manual til dansk Joe Hansen <joedalton2@yahoo.dk>

Denne oversættelse er gratis dokumentation; læs GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR.

Hvis du støder på fejl i oversættelsen af ​​denne vejledning, skal du sende en besked til debian-l10n-danish@lists.debian.org.