xref: /original-bsd/usr.bin/tee/tee.1 (revision c3e32dec)
1.\" Copyright (c) 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the Institute of Electrical and Electronics Engineers, Inc.
6.\"
7.\" %sccs.include.redist.roff%
8.\"
9.\"     @(#)tee.1	8.1 (Berkeley) 06/06/93
10.\"
11.Dd
12.Dt TEE 1
13.Os
14.Sh NAME
15.Nm tee
16.Nd pipe fitting
17.Sh SYNOPSIS
18.Nm tee
19.Op Fl ai
20.Op Ar file ...
21.Sh DESCRIPTION
22The
23.Nm tee
24utility copies standard input to standard output,
25making a copy in zero or more files.
26The output is unbuffered.
27.Pp
28The following options are available:
29.Bl -tag -width Ds
30.It Fl a
31Append the output to the files rather than
32overwriting them.
33.It Fl i
34Ignore the
35.Dv SIGINT
36signal.
37.El
38.Pp
39The following operands are available:
40.Bl -tag -width file
41.It file
42A pathname of an output
43.Ar file .
44.El
45.Pp
46The
47.Nm tee
48utility takes the default action for all signals,
49except in the event of the
50.Fl i
51option.
52.Pp
53The
54.Nm tee
55utility exits 0 on success, and >0 if an error occurs.
56.Sh STANDARDS
57The
58.Nm tee
59function is expected to be
60.Tn POSIX
61.St -p1003.2
62compatible.
63