# tee - read from standard input and write to standard output ... - man - [phpMan]

> **TLDR:** Read from `stdin` and write to `stdout` and files (or commands).
>
- 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|--append}} {{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|--bytes}})`

*Source: tldr-pages*

---

[_TEE_(1)](https://www.chedong.com/phpMan.php/man/TEE/1/markdown)                                      User Commands                                     [_TEE_(1)](https://www.chedong.com/phpMan.php/man/TEE/1/markdown)

## 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     

       **--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  speci‐
       fied,  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 © 2023 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'

GNU coreutils 9.4                           January 2026                                      [_TEE_(1)](https://www.chedong.com/phpMan.php/man/TEE/1/markdown)