tee

- replicate the standard output

Synopsis

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

Description

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

The following options are supported:

-a

Appends the output to the files rather than overwriting them.

-i

Ignores interrupts.

Operands

The following operands are supported:

file

A path name of an output file.

Usage

See largefile(5) for the description of the behavior of tee when encountering files greater than or equal to 2 Gbyte (2³¹ bytes).

Environment Variables

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

Exit Status

The following exit values are returned:

0

Successful completion. The standard input was successfully copied to all output files.

>0

An error occurred. The number of files that could not be opened or whose status could not be obtained.

Attributes

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

See Also

cat(1), attributes(5), environ(5), largefile(5), standards(5)