| 1 | tee
|
| 2 | ===
|
| 3 |
|
| 4 | 从标准输入读取数据并重定向到标准输出和文件。
|
| 5 |
|
| 6 | ## 概要
|
| 7 |
|
| 8 | ```shell
|
| 9 | tee [OPTION]... [FILE]...
|
| 10 | ```
|
| 11 |
|
| 12 | ## 主要用途
|
| 13 |
|
| 14 | - 需要同时查看数据内容并输出到文件时使用。
|
| 15 |
|
| 16 | ## 参数
|
| 17 |
|
| 18 | FILE（可选）：要输出的文件，可以为一或多个。
|
| 19 |
|
| 20 | ## 选项
|
| 21 |
|
| 22 | ```shell
|
| 23 | 长选项与短选项等价
|
| 24 |
|
| 25 | -a, --append 追加到文件中而不是覆盖。
|
| 26 | -i, --ignore-interrupts 忽略中断信号（Ctrl+c中断操作无效）。
|
| 27 | -p 诊断写入非管道的错误。
|
| 28 | --output-error[=MODE] 设置写错误时的行为，请查看下方的MODE部分。
|
| 29 | --help 显示帮助信息并退出。
|
| 30 | --version 显示版本信息并退出。
|
| 31 |
|
| 32 | MODE决定了当出现写错误时的输出行为，可用的MODE如下：
|
| 33 |
|
| 34 | 'warn' 当写入到任何输出报错时诊断。
|
| 35 | 'warn-nopipe' 当写入到任何输出（而不是管道）报错时诊断。
|
| 36 | 'exit' 当写入到任何输出报错时退出。
|
| 37 | 'exit-nopipe' 当写入到任何输出（而不是管道）报错时退出。
|
| 38 |
|
| 39 | -p选项的指定的默认MODE为'warn-nopipe'。
|
| 40 | 当'--output-error'没有在选项中时，默认的操作是当写入到管道报错时立刻退出，诊断错误信息并写入到非管道输出。
|
| 41 | ```
|
| 42 |
|
| 43 | ## 返回值
|
| 44 |
|
| 45 | 返回状态为成功除非给出了非法选项或非法参数。
|
| 46 |
|
| 47 | ## 例子
|
| 48 |
|
| 49 | ```shell
|
| 50 | # 将进程信息通过管道输出到标准输出（终端）并覆盖写入到文件中。
|
| 51 | ps -ef |tee info_a.log info_b.log
|
| 52 |
|
| 53 | # 将进程信息通过管道输出到标准输出（终端）并追加写入到文件中。
|
| 54 | ps -ef |tee -a info_a.log info_b.log
|
| 55 | ```
|
| 56 |
|
| 57 | ### 注意
|
| 58 |
|
| 59 | 1. 该命令是`GNU coreutils`包中的命令，相关的帮助信息请查看`man -s 1 tee`或`info coreutils 'tee invocation'`。
|
| 60 | 2. 存在缓存机制，每1024个字节将输出一次。若从管道接收输入数据，应该是缓冲区满，才将数据转存到指定的文件中。若文件内容不到1024个字节，则接收从标准输入设备读入的数据后，将刷新一次缓冲区，并转存数据到指定文件。
|
| 61 |
|
| 62 |
|