tee — read from standard input and write to standard output and files
Examples (TL;DR)
-
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 directory called "example", count the number of characters in "example" and write "example" to the terminal:
echo "example" | tee >(xargs mkdir) >(wc -c)
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.
Reporting Bugs
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>
Copyright
Copyright © 2019 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
See Also
Full documentation <https://www.gnu.org/software/coreutils/tee>
or available locally via: info '(coreutils) tee invocation'
Referenced By
libpipeline(3), pee(1), rc(1), tee(2), xs(1).