tee(1) — Reliant UNIX 5.44c4

tee(1)                                                               tee(1)

NAME
     tee - join pipes and make copies of input

SYNOPSIS
     tee [-a] [-i] [--] [file ...]

DESCRIPTION
     tee transcribes data from standard input to standard output and simul-
     taneously copies this data to the specified file.

OPTIONS
     -a   (append) tee appends its output to the original contents of file
          if file already exists when tee is invoked.

          -a not specified:

          If file exists when tee is invoked, the original contents of file
          are overwritten.

     -i   (i - ignore) The SIGINT signal [see kill(1)] is ignored.

     --   End of the list of options. Must be specified if file begins with
          -.

     file Name of the file to which tee is to write its output. If file
          does not exist when you call tee, a new file is created; if it
          does exist, tee either overwrites its contents or appends the
          output to it, depending on whether or not the -a option is used.
          If you specify more than one file, tee writes its entire output
          to each file.

          file not specified:

          tee writes its output to standard output only.

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed. If LCMESSAGES is undefined or is defined
     as the null string, it defaults to the value of LANG. If LANG is like-
     wise undefined or null, the system acts as if it were not internation-
     alized.

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.










Page 1                       Reliant UNIX 5.44                Printed 11/98

tee(1)                                                               tee(1)

EXAMPLES
     Use of the tee command in a pipe:

     $ (date; who) | tee security | wc -l
           5
     $ cat security
     Fri Aug 02 14:16:10 MET 1991
     felix    tty012   Aug  2 10:37
     jane     tty013   Aug  2 08:37
     tina     tty003   Aug  2 11:54
     eddy     tty004   Aug  2 11:13

     The date and who commands send the current date and information on all
     users currently logged in to standard output. The first pipe redirects
     this output to tee's standard input. tee reads this input and copies
     it to the file security and to standard output. The second pipe sends
     the standard output of tee to the standard input of the wc -l command;
     wc -l writes the number of read lines to standard output:

     5 (4 users logged in and 1 line for the date).


































Page 2                       Reliant UNIX 5.44                Printed 11/98

Museum