tee (1)

Quick Reference

Read from standard input and write to standard output and files (or commands).

  • Copy standard input to each FILE, and also to standard output:

echo "example" | tee {{FILE}}

  • Append to the given FILEs, do not overwrite:

echo "example" | tee -a {{FILE}}

  • Print standard input to the terminal, and also pipe it into another program for further processing:

echo "example" | tee {{/dev/tty}} | {{xargs printf "[%s]"}}

  • Create a folder called "example", count the number of characters in "example" and write "example" to the terminal:

echo "example" | tee >(xargs mkdir) >(wc -c)

NAME

tee - read from standard input and write to standard output and files

SYNOPSIS

tee [ OPTION]... [FILE]...

DESCRIPTION

Copy standard input to each FILE, and also to standard output.
-a, --append
append to the given FILEs, do not overwrite
-i, --ignore-interrupts
ignore interrupt signals
-p
diagnose errors writing to non pipes
--output-error[=MODE]
set behavior on write error. See MODE below
--help
display this help and exit
--version
output version information and exit

MODE determines behavior with write errors on the outputs:

'warn'
diagnose errors writing to any output
'warn-nopipe'
diagnose errors writing to any output not a pipe
'exit'
exit on error writing to any output
'exit-nopipe'
exit on error writing to any output not a pipe
The default MODE for the -p option is 'warn-nopipe'. The default operation when --output-error is not specified, is to exit immediately on error writing to a pipe, and diagnose errors writing to non pipe outputs.

AUTHOR

Written by Mike Parker, Richard M. Stallman, and David MacKenzie.

REPORTING BUGS

GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
 
Report tee translation bugs to <https://translationproject.org/team/>

SEE ALSO

Full documentation at: <https://www.gnu.org/software/coreutils/tee>
 
or available locally via: info '(coreutils) tee invocation'

Information

Source
Coreutils
OS/version
GNU coreutils 8.29.13-0a854
Source updated
December 2, 2018
Page created
February 9, 2018
Page generated
December 2, 2018