1 .\" Copyright (c) 1986, 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. Neither the name of the University nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" @(#)who.1 8.2 (Berkeley) 12/30/93
35 .Nd display who is on the system
44 utility displays information about currently logged in users.
45 By default, this includes the login name, tty name, date and time of login and
46 remote hostname if not local.
48 The options are as follows:
49 .Bl -tag -width indent
53 with the exception that output is not restricted to the time and date of
54 the last system reboot.
56 Write the time and date of the last system reboot.
58 Write column headings above the output.
60 Show information about the terminal attached to standard input only.
63 List the names and number of logged in users in columns.
64 All other command line options are ignored.
66 Show the name, line and time fields only.
69 Indicate whether each user is accepting messages.
70 One of the following characters is written:
72 .Bl -tag -width 1n -compact
74 User is accepting messages.
76 User is not accepting messages.
81 Show idle time for each user in hours and minutes as
84 if the user has been idle less than a minute, and
86 if the user has been idle more than 24 hours.
94 gathers information from the file
95 .Pa /var/run/utx.active .
98 may be specified which is usually
101 .Pa /var/log/utx.log.[0-6]
102 depending on site policy as
104 can grow quite large and daily versions may or may not
105 be kept around after compression by
109 file contains a record of every login, logout,
110 crash, shutdown and date change
113 was last truncated or
118 is being used as the file, the user name may be empty
119 or one of the special characters '|', '}' and '~'.
121 an output line without any user name.
122 For more information on the
123 special characters, see
127 .Ev COLUMNS , LANG , LC_ALL
130 environment variables affect the execution of
135 .Bl -tag -width /var/log/utx.log.[0-6] -compact
136 .It Pa /var/run/utx.active
137 .It Pa /var/log/utx.log
138 .It Pa /var/log/utx.log.[0-6]
143 Show a brief summary of who is logged in:
144 .Bd -literal -offset indent
150 Show who is logged in along with the line and time fields (without the headers):
151 .Bd -literal -offset indent
153 fernape ttyv0 Aug 26 16:23
154 root ttyv1 Aug 26 16:23
155 root ttyv2 Aug 26 16:23
158 Show information about the terminal attached to standard input:
159 .Bd -literal -offset indent
164 Show time and date of the last system reboot, whether the users accept messages
165 and the idle time for each of them:
166 .Bd -literal -offset indent
168 - system boot Aug 26 16:23 .
169 fernape - ttyv0 Aug 26 16:23 .
170 root - ttyv1 Aug 26 16:23 .
171 root - ttyv2 Aug 26 16:23 .
174 Same as above but showing headers:
175 .Bd -literal -offset indent
177 NAME S LINE TIME IDLE FROM
178 - system boot Aug 26 16:23 .
179 fernape - ttyv0 Aug 26 16:23 .
180 root - ttyv1 Aug 26 16:23 00:01
181 root - ttyv2 Aug 26 16:23 00:01