Print this page
13507 some man pages need update following 13405
6308 some man pages are obsolete after moving to ksh builtins

*** 41,268 **** .\" .\" .\" Copyright 1989 AT&T .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved .\" ! .TH TEE 1 "Nov 20, 2007" ! .SH NAME ! tee \- replicate the standard output ! .SH SYNOPSIS ! .SS "/usr/bin/tee" ! .LP ! .nf ! \fB/usr/bin/tee\fR [\fB-ai\fR] [\fIfile\fR]... ! .fi ! ! .SS "ksh93" ! .LP ! .nf ! \fBtee\fR [\fB-ail\fR] [\fIfile\fR]... ! .fi ! ! .SH DESCRIPTION ! .SS "/usr/bin/tee" ! .sp ! .LP ! \fB/usr/bin/tee\fR copies standard input to standard output, making a copy in ! zero or more files. \fBtee\fR does not buffer its output. The options determine ! if the specified files are overwritten or appended to. ! .SS "ksh93" ! .sp ! .LP ! The \fBtee\fR built-in in \fBksh93\fR is associated with the \fB/bin\fR and ! \fB/usr/bin\fR paths. It is invoked when tee is executed without a pathname ! prefix and the pathname search finds a \fB/bin/tee\fR or \fB/usr/bin/tee\fR ! executable. ! .sp ! .LP ! \fBtee\fR copies standard input to standard output and to zero or more files. ! The options determine whether the specified files are overwritten or appended ! to. The tee utility does not buffer output. If a write to a file fails, ! \fBtee\fR continues to write to other files although it exits with a non-zero exit status. ! .sp ! .LP ! The number of \fIfile\fR operands that can be specified is limited by the ! underlying operating system. ! .SH OPTIONS ! .SS "/usr/bin/tee" ! .sp ! .LP ! The following options are supported by \fB/usr/bin/tee\fR: ! .sp ! .ne 2 ! .na ! \fB\fB-a\fR\fR ! .ad ! .RS 6n Appends the output to the files rather than overwriting them. ! .RE ! ! .sp ! .ne 2 ! .na ! \fB\fB-i\fR\fR ! .ad ! .RS 6n ! Ignores interrupts. ! .RE ! ! .SS "ksh93" ! .sp ! .LP ! The following options are supported by the \fBtee\fR built-in command in ! \fBksh93\fR: ! .sp ! .ne 2 ! .na ! \fB\fB-a\fR\fR ! .ad ! .br ! .na ! \fB\fB--append\fR\fR ! .ad ! .RS 23n ! Appends the output to the files rather than overwriting them. ! .RE ! ! .sp ! .ne 2 ! .na ! \fB\fB-i\fR\fR ! .ad ! .br ! .na ! \fB\fB--ignore-interrupts\fR\fR ! .ad ! .RS 23n ! Ignores \fBSIGINT\fR signal. ! .RE ! ! .sp ! .ne 2 ! .na ! \fB\fB-l\fR\fR ! .ad ! .br ! .na ! \fB\fB--line-buffer\fR\fR ! .ad ! .RS 23n Sets the standard output to be line buffered. ! .RE ! ! .SH OPERANDS ! .sp ! .LP The following operands are supported: ! .sp ! .ne 2 ! .na ! \fB\fIfile\fR\fR ! .ad ! .RS 8n ! A path name of an output file. Processing of at least 13 \fIfile\fR operands ! are supported. ! .RE ! ! .SH USAGE ! .sp ! .LP ! See \fBlargefile\fR(5) for the description of the behavior of \fBtee\fR when ! encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). ! .SH ENVIRONMENT VARIABLES ! .sp ! .LP ! See \fBenviron\fR(5) for descriptions of the following environment variables ! that affect the execution of \fBtee\fR: \fBLANG\fR, \fBLC_ALL\fR, ! \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. ! .SH EXIT STATUS ! .SS "/usr/bin/tee" ! .sp ! .LP ! The following exit values are returned by \fB/usr/bin/tee\fR: ! .sp ! .ne 2 ! .na ! \fB\fB0\fR\fR ! .ad ! .RS 6n ! The standard input was successfully copied to all output files. ! .RE ! ! .sp ! .ne 2 ! .na ! \fB\fB>0\fR\fR ! .ad ! .RS 6n ! The number of files that could not be opened or whose status could not be ! obtained. ! .RE ! ! .SS "ksh93" ! .sp ! .LP ! The following exit values are returned by \fBtee\fR in \fBksh93\fR: ! .sp ! .ne 2 ! .na ! \fB\fB0\fR\fR ! .ad ! .RS 6n ! Successful completion. ! .RE ! ! .sp ! .ne 2 ! .na ! \fB\fB>0\fR\fR ! .ad ! .RS 6n An error occurred. ! .RE ! ! .SH ATTRIBUTES ! .sp ! .LP ! See \fBattributes\fR(5) for descriptions of the following attributes: ! .SS "/usr/bin/tee" ! .sp ! ! .sp ! .TS ! box; ! c | c ! l | l . ! ATTRIBUTE TYPE ATTRIBUTE VALUE ! _ ! CSI Enabled ! _ ! Interface Stability Committed ! _ ! Standard See \fBstandards\fR(5). ! .TE ! ! .SS "ksh93" ! .sp ! ! .sp ! .TS ! box; ! c | c ! l | l . ! ATTRIBUTE TYPE ATTRIBUTE VALUE ! _ ! Interface Stability See below. ! .TE ! ! .sp ! .LP ! The \fBksh93\fR built-in binding to \fB/bin\fR and \fB/usr/bin\fR is Volatile. ! The built-in interfaces are Uncommitted. ! .SH SEE ALSO ! .sp ! .LP ! \fBcat\fR(1), \fBksh93\fR(1), \fBattributes\fR(5), \fBenviron\fR(5), ! \fBlargefile\fR(5), \fBstandards\fR(5) --- 41,150 ---- .\" .\" .\" Copyright 1989 AT&T .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved + .\" Portions Copyright 2021 OmniOS Community Edition (OmniOSce) Association. .\" ! .Dd Feb 9, 2021 ! .Dt TEE 1 ! .Os ! .Sh NAME ! .Nm tee ! .Nd replicate the standard output ! .Sh SYNOPSIS ! .Nm ! .Op Fl ail ! .Oo Ar file Oc Ns ... ! .Sh DESCRIPTION ! .Nm ! copies standard input to standard output, making a copy in zero or more files. ! .Nm ! does not buffer its output by default ! .Po but see the Fl l No option Pc . ! The options determine if the specified files are overwritten or appended to. ! If a write to a file fails, ! .Nm ! continues to write to other files although it exits with a non-zero exit status. ! .Ss ksh93 ! The ! .Nm ! built-in in ! .Xr ksh93 1 ! is associated with the ! .Pa /bin ! and ! .Pa /usr/bin ! paths. ! It is invoked when ! .Nm ! is executed without a pathname prefix and the pathname search finds a ! .Pa /bin/tee ! or ! .Pa /usr/bin/tee ! executable. ! .Sh OPTIONS ! The following options are supported: ! .Bl -tag -width Ar ! .It Fl a Ns \&, Fl \-append Appends the output to the files rather than overwriting them. ! .It Fl i Ns \&, Fl \-ignore-interrupts ! Ignores ! .Sy SIGINT ! signal. ! .It Fl l Ns \&, Fl \-linebuffer Sets the standard output to be line buffered. ! .El ! .Sh OPERANDS The following operands are supported: ! .Bl -tag -width Ar ! .It Ar file ! A path name of an output file. ! Processing of at least 13 ! .Ar file ! operands is supported. ! .El ! .Sh EXIT STATUS ! .Bl -tag -width Ds ! .It Sy 0 ! All files copied successfully. ! .It Sy >0 An error occurred. ! .El ! .Sh ENVIRONMENT VARIABLES ! See ! .Xr environ 5 ! for descriptions of the following environment variables ! that affect the execution of ! .Nm : ! .Ev LANG , ! .Ev LC_ALL , ! .Ev LC_TYPE , ! .Ev LC_MESSAGES , ! .Ev LC_NUMERIC , ! and ! .Ev NLSPATH . ! .Sh INTERFACE STABILITY ! The command line interface of ! .Nm ! is ! .Sy Committed . ! The output of ! .Nm ! is ! .Sy Committed . ! The ! .Xr ksh93 1 ! built-in binding to ! .Pa /bin ! and ! .Pa /usr/bin ! is ! .Sy Volatile . ! .Sh SEE ALSO ! .Xr cat 1 , ! .Xr ksh93 1 , ! .Xr attributes 5 , ! .Xr environ 5 , ! .Xr largefile 5 , ! .Xr standards 5