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