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)