gno/bin/tee/tee.1

55 lines
1008 B
Groff
Raw Normal View History

.TH TEE 1 "Commands and Applications" "23 November 1994" "Version 1.1"
.SH NAME
tee \- Pipe fitting.
.SH SYNOPSIS
.B tee
[
.I -ai
]
.I file1
[
.IR file2 ...
]
.SH DESCRIPTION
The
.B tee
utility copies standard input to standard
output, making a copy in
.IR file1 ,
.IR file2 ,
etc.
The standard output is unbuffered, while output to the
.IR file s
is fully buffered
.LP
The following options are available:
.IP "\fI-a\fR
Append the output to the
.IR file s
rather than overwriting them.
.br
.IP "\fI-i\fR
Ignore the SIGINT signal.
.RE
.LP
The
.B tee
utility takes the default action for all
signals, except in the event of the
.I -i
option.
.LP
If an error occurs while reading stdin, only the first specified
.I file
will contain the output up to that point.
.LP
The return value is 0 on success, and 1 if an error
occurs.
.SH STANDARDS
.B Tee
is POSIX p1003.2 compatible.
.SH HISTORY
.B Tee
first appeared in Gno v1.x. Version 1.1 updated by Devin Reade
to use proper (non) buffering.