tee - Man Page

read from standard input and write to standard output and files

Examples (TL;DR)

Copy stdin to each file, and also to stdout: echo "example" | tee path/to/file
Append to the given files, do not overwrite: echo "example" | tee -a path/to/file
Print stdin 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)

tldr.sh

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: operate in a more appropriate MODE with 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'. With "nopipe" MODEs, exit immediately if all outputs become broken pipes. 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 any translation bugs to <https://translationproject.org/team/>

Copyright

Copyright © 2024 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.

Referenced By

libpipeline(3), pee(1), rc(1), tee(2).

April 2024 GNU coreutils 9.5