file is an output file, not an input file
[unix-history] / usr / src / usr.bin / tee / tee.1
CommitLineData
394a7f3c
CL
1.\" Copyright (c) 1991 Regents of the University of California.
2.\" All rights reserved.
31cfa0ca 3.\"
ae122740
KB
4.\" This code is derived from software contributed to Berkeley by
5.\" the Institute of Electrical and Electronics Engineers, Inc.
6.\"
394a7f3c
CL
7.\" %sccs.include.redist.roff%
8.\"
dae9fe5a 9.\" @(#)tee.1 6.4 (Berkeley) %G%
394a7f3c
CL
10.\"
11.Dd
12.Dt TEE 1
13.Os BSD 4.4
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
dae9fe5a 42A pathname of an output
394a7f3c 43.Ar file .
394a7f3c
CL
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
611003.2 compatible.