Annotation of src/usr.bin/tee/tee.1, Revision 1.7
1.7 ! jmc 1: .\" $OpenBSD: tee.1,v 1.6 2007/05/30 04:41:34 jmc Exp $
1.1 deraadt 2: .\" $NetBSD: tee.1,v 1.4 1994/12/09 01:43:37 jtc Exp $
3: .\"
4: .\" Copyright (c) 1991, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" This code is derived from software contributed to Berkeley by
8: .\" the Institute of Electrical and Electronics Engineers, Inc.
9: .\"
10: .\" Redistribution and use in source and binary forms, with or without
11: .\" modification, are permitted provided that the following conditions
12: .\" are met:
13: .\" 1. Redistributions of source code must retain the above copyright
14: .\" notice, this list of conditions and the following disclaimer.
15: .\" 2. Redistributions in binary form must reproduce the above copyright
16: .\" notice, this list of conditions and the following disclaimer in the
17: .\" documentation and/or other materials provided with the distribution.
1.5 millert 18: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 19: .\" may be used to endorse or promote products derived from this software
20: .\" without specific prior written permission.
21: .\"
22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: .\" SUCH DAMAGE.
33: .\"
34: .\" @(#)tee.1 8.1 (Berkeley) 6/6/93
35: .\"
1.7 ! jmc 36: .Dd $Mdocdate$
1.1 deraadt 37: .Dt TEE 1
38: .Os
39: .Sh NAME
40: .Nm tee
41: .Nd pipe fitting
42: .Sh SYNOPSIS
43: .Nm tee
44: .Op Fl ai
45: .Op Ar file ...
46: .Sh DESCRIPTION
47: The
1.4 aaron 48: .Nm
1.1 deraadt 49: utility copies standard input to standard output,
50: making a copy in zero or more files.
51: The output is unbuffered.
52: .Pp
1.4 aaron 53: The options are as follows:
1.1 deraadt 54: .Bl -tag -width Ds
55: .It Fl a
56: Append the output to the files rather than
57: overwriting them.
58: .It Fl i
59: Ignore the
60: .Dv SIGINT
61: signal.
62: .El
63: .Pp
64: The following operands are available:
65: .Bl -tag -width file
1.3 aaron 66: .It Ar file
1.1 deraadt 67: A pathname of an output
68: .Ar file .
69: .El
70: .Pp
71: The
1.4 aaron 72: .Nm
1.1 deraadt 73: utility takes the default action for all signals,
74: except in the event of the
75: .Fl i
76: option.
77: .Pp
78: The
1.4 aaron 79: .Nm
1.3 aaron 80: utility exits 0 on success or >0 if an error occurred.
1.1 deraadt 81: .Sh STANDARDS
82: The
1.4 aaron 83: .Nm
1.6 jmc 84: utility is compliant with the
85: .St -p1003.1-2004
86: specification.