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
33 .Nd display who is on the system
42 utility displays information about currently logged in users.
43 By default, this includes the login name, tty name, date and time of login and
44 remote hostname if not local.
46 The options are as follows:
47 .Bl -tag -width indent
51 with the exception that output is not restricted to the time and date of
52 the last system reboot.
54 Write the time and date of the last system reboot.
56 Write column headings above the output.
58 Show information about the terminal attached to standard input only.
61 List the names and number of logged in users in columns.
62 All other command line options are ignored.
64 Show the name, line and time fields only.
67 Indicate whether each user is accepting messages.
68 One of the following characters is written:
70 .Bl -tag -width 1n -compact
72 User is accepting messages.
74 User is not accepting messages.
79 Show idle time for each user in hours and minutes as
82 if the user has been idle less than a minute, and
84 if the user has been idle more than 24 hours.
92 gathers information from the file
93 .Pa /var/run/utx.active .
96 may be specified which is usually
99 .Pa /var/log/utx.log.[0-6]
100 depending on site policy as
102 can grow quite large and daily versions may or may not
103 be kept around after compression by
107 file contains a record of every login, logout,
108 crash, shutdown and date change
111 was last truncated or
116 is being used as the file, the user name may be empty
117 or one of the special characters '|', '}' and '~'.
119 an output line without any user name.
120 For more information on the
121 special characters, see
125 .Ev COLUMNS , LANG , LC_ALL
128 environment variables affect the execution of
133 .Bl -tag -width /var/log/utx.log.[0-6] -compact
134 .It Pa /var/run/utx.active
135 .It Pa /var/log/utx.log
136 .It Pa /var/log/utx.log.[0-6]
141 Show a brief summary of who is logged in:
142 .Bd -literal -offset indent
148 Show who is logged in along with the line and time fields (without the headers):
149 .Bd -literal -offset indent
151 fernape ttyv0 Aug 26 16:23
152 root ttyv1 Aug 26 16:23
153 root ttyv2 Aug 26 16:23
156 Show information about the terminal attached to standard input:
157 .Bd -literal -offset indent
162 Show time and date of the last system reboot, whether the users accept messages
163 and the idle time for each of them:
164 .Bd -literal -offset indent
166 - system boot Aug 26 16:23 .
167 fernape - ttyv0 Aug 26 16:23 .
168 root - ttyv1 Aug 26 16:23 .
169 root - ttyv2 Aug 26 16:23 .
172 Same as above but showing headers:
173 .Bd -literal -offset indent
175 NAME S LINE TIME IDLE FROM
176 - system boot Aug 26 16:23 .
177 fernape - ttyv0 Aug 26 16:23 .
178 root - ttyv1 Aug 26 16:23 00:01
179 root - ttyv2 Aug 26 16:23 00:01