# tee(1) - 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'.  The default operation when **--output-er**‐‐
       **ror** 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  ©  2020 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 8.32                          January 2026                                      [TEE(1)](https://www.chedong.com/phpMan.php/man/TEE/1/markdown)