tee(1) - osol9

1tee(1)                           User Commands                          tee(1)
2
3
4

NAME

6       tee - replicate the standard output
7

SYNOPSIS

9   /usr/bin/tee
10       /usr/bin/tee [-ai] [file]...
11
12
13   ksh93
14       tee [-ail] [file]...
15
16

DESCRIPTION

18   /usr/bin/tee
19       /usr/bin/tee copies standard input to standard output, making a copy in
20       zero or more files. tee does not buffer its output. The options  deter‐
21       mine if the specified files are overwritten or appended to.
22
23   ksh93
24       The  tee  built-in  in  ksh93  is associated with the /bin and /usr/bin
25       paths. It is invoked when tee is executed without a pathname prefix and
26       the pathname search finds a /bin/tee or /usr/bin/tee executable.
27
28
29       tee copies standard input to standard output and to zero or more files.
30       The options determine whether the specified files  are  overwritten  or
31       appended  to.  The  tee utility does not buffer output. If a write to a
32       file fails, tee continues to write to other  files  although  it  exits
33       with a non-zero exit status.
34
35
36       The  number  of  file  operands that can be specified is limited by the
37       underlying operating system.
38

OPTIONS

40   /usr/bin/tee
41       The following options are supported by /usr/bin/tee:
42
43       -a    Appends the output to the files rather than overwriting them.
44
45
46       -i    Ignores interrupts.
47
48
49   ksh93
50       The following options are supported by  the  tee  built-in  command  in
51       ksh93:
52
53       -a                     Appends  the  output  to  the  files rather than
54       --append               overwriting them.
55
56
57       -i                     Ignores SIGINT signal.
58       --ignore-interrupts
59
60       -l                     Sets the standard output to be line buffered.
61       --line-buffer
62

OPERANDS

64       The following operands are supported:
65
66       file    A path name of an output file. Processing of at least  13  file
67               operands are supported.
68
69

USAGE

71       See  largefile(5)  for  the  description  of  the  behavior of tee when
72       encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
73

ENVIRONMENT VARIABLES

75       See environ(5) for descriptions of the following environment  variables
76       that  affect the execution of tee: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES,
77       and NLSPATH.
78

EXIT STATUS

80   /usr/bin/tee
81       The following exit values are returned by /usr/bin/tee:
82
83       0     The standard input was successfully copied to all output files.
84
85
86       >0    The number of files that could not  be  opened  or  whose  status
87             could not be obtained.
88
89
90   ksh93
91       The following exit values are returned by tee in ksh93:
92
93       0     Successful completion.
94
95
96       >0    An error occurred.
97
98

ATTRIBUTES

100       See attributes(5) for descriptions of the following attributes:
101
102   /usr/bin/tee
103       ┌─────────────────────────────┬─────────────────────────────┐
104       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
105       ├─────────────────────────────┼─────────────────────────────┤
106       │Availability                 │SUNWcsu                      │
107       ├─────────────────────────────┼─────────────────────────────┤
108       │CSI                          │Enabled                      │
109       ├─────────────────────────────┼─────────────────────────────┤
110       │Interface Stability          │Committed                    │
111       ├─────────────────────────────┼─────────────────────────────┤
112       │Standard                     │See standards(5).            │
113       └─────────────────────────────┴─────────────────────────────┘
114
115   ksh93
116       ┌─────────────────────────────┬─────────────────────────────┐
117       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
118       ├─────────────────────────────┼─────────────────────────────┤
119       │Availability                 │SUNWcsu                      │
120       ├─────────────────────────────┼─────────────────────────────┤
121       │Interface Stability          │See below.                   │
122       └─────────────────────────────┴─────────────────────────────┘
123
124
125       The ksh93 built-in binding to /bin and /usr/bin is Volatile. The built-
126       in interfaces are Uncommitted.
127