annotate docs/nitros9guide/tee.refentry @ 2909:b71f67993fe0

level2/coco3/makefile: Use OS9FORMAT macro
author Tormod Volden <debian.tormod@gmail.com>
date Sat, 11 Jan 2014 20:56:53 +0100
parents 4dae346c4969
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="tee">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>TEE</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Copy standard input to multiple output paths</refpurpose>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
6
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>tee</command>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
11 &repeatst;<replaceable>path</replaceable>&repeaten;
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
13 </cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
14 </refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
15
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
16 <refsect1><title>Description</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
17
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
18 <para>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
19 This command is a filter (see <xref linkend="sec4.3.3"/>) that copies all text lines from
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 its standard input path to the standard output path
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
21 <emphasis>and</emphasis> any number
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 of additional output paths whose pathlists are given as parameters.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
23 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
24 <para>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
25 The example below uses a pipeline and <command>tee</command> to simultaneously send the
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
26 output listing of the <command>dir</command> command to the terminal, printer, and a
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
27 disk file:
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
30 dir e ! tee /printer /d0/dir.listing
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
31 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
32 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
33 The following example sends the output of an assembler listing to a
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
34 disk file and the printer:
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
36 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37 asm pgm.src l ! tee pgm.list &gt;/printer
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
40 The example below &quot;broadcasts&quot; a message to four terminals:
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43 echo WARNING System down in 10 minutes ! tee /t1 /t2 /t3 /t4
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
44 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
45 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47