TEE(1) User Commands TEE(1)


NAME


tee - replicate the standard output

SYNOPSIS


/usr/bin/tee
/usr/bin/tee [-ai] [file]...


ksh93
tee [-ail] [file]...


DESCRIPTION


/usr/bin/tee
/usr/bin/tee copies standard input to standard output, making a copy in
zero or more files. tee does not buffer its output. The options determine
if the specified files are overwritten or appended to.

ksh93
The tee built-in in ksh93 is associated with the /bin and /usr/bin paths.
It is invoked when tee is executed without a pathname prefix and the
pathname search finds a /bin/tee or /usr/bin/tee executable.


tee copies standard input to standard output and to zero or more files.
The options determine whether the specified files are overwritten or
appended to. The tee utility does not buffer output. If a write to a file
fails, tee continues to write to other files although it exits with a
non-zero exit status.


The number of file operands that can be specified is limited by the
underlying operating system.

OPTIONS


/usr/bin/tee
The following options are supported by /usr/bin/tee:

-a
Appends the output to the files rather than overwriting them.


-i
Ignores interrupts.


ksh93
The following options are supported by the tee built-in command in ksh93:

-a
--append
Appends the output to the files rather than
overwriting them.


-i
--ignore-interrupts
Ignores SIGINT signal.


-l
--line-buffer
Sets the standard output to be line buffered.


OPERANDS


The following operands are supported:

file
A path name of an output file. Processing of at least 13 file
operands are supported.


USAGE


See largefile(7) for the description of the behavior of tee when
encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).

ENVIRONMENT VARIABLES


See environ(7) for descriptions of the following environment variables
that affect the execution of tee: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES,
and NLSPATH.

EXIT STATUS


/usr/bin/tee
The following exit values are returned by /usr/bin/tee:

0
The standard input was successfully copied to all output files.


>0
The number of files that could not be opened or whose status could
not be obtained.


ksh93
The following exit values are returned by tee in ksh93:

0
Successful completion.


>0
An error occurred.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:

/usr/bin/tee


+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|CSI | Enabled |
+--------------------+-------------------+
|Interface Stability | Committed |
+--------------------+-------------------+
|Standard | See standards(7). |
+--------------------+-------------------+

ksh93


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+


The ksh93 built-in binding to /bin and /usr/bin is Volatile. The built-
in interfaces are Uncommitted.

SEE ALSO


cat(1), ksh93(1), attributes(7), environ(7), largefile(7), standards(7)


November 20, 2007 TEE(1)