1.\" Copyright (c) 1986, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 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. 15.\" 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 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)who.1 8.2 (Berkeley) 12/30/93 29.\" $FreeBSD$ 30.\" 31.Dd August 30, 2020 32.Dt WHO 1 33.Os 34.Sh NAME 35.Nm who 36.Nd display who is on the system 37.Sh SYNOPSIS 38.Nm 39.Op Fl abHmqsTu 40.Op Cm am I 41.Op Ar file 42.Sh DESCRIPTION 43The 44.Nm 45utility displays information about currently logged in users. 46By default, this includes the login name, tty name, date and time of login and 47remote hostname if not local. 48.Pp 49The options are as follows: 50.Bl -tag -width indent 51.It Fl a 52Equivalent to 53.Fl bTu , 54with the exception that output is not restricted to the time and date of 55the last system reboot. 56.It Fl b 57Write the time and date of the last system reboot. 58.It Fl H 59Write column headings above the output. 60.It Fl m 61Show information about the terminal attached to standard input only. 62.It Fl q 63.Dq "Quick mode" : 64List the names and number of logged in users in columns. 65All other command line options are ignored. 66.It Fl s 67Show the name, line and time fields only. 68This is the default. 69.It Fl T 70Indicate whether each user is accepting messages. 71One of the following characters is written: 72.Pp 73.Bl -tag -width 1n -compact 74.It Li + 75User is accepting messages. 76.It Li \&- 77User is not accepting messages. 78.It Li \&? 79An error occurred. 80.El 81.It Fl u 82Show idle time for each user in hours and minutes as 83.Ar hh : Ns Ar mm , 84.Ql \&. 85if the user has been idle less than a minute, and 86.Dq Li old 87if the user has been idle more than 24 hours. 88.It Cm am I 89Equivalent to 90.Fl m . 91.El 92.Pp 93By default, 94.Nm 95gathers information from the file 96.Pa /var/run/utx.active . 97An alternate 98.Ar file 99may be specified which is usually 100.Pa /var/log/utx.log 101(or 102.Pa /var/log/utx.log.[0-6] 103depending on site policy as 104.Pa utx.log 105can grow quite large and daily versions may or may not 106be kept around after compression by 107.Xr ac 8 ) . 108The 109.Pa utx.log 110file contains a record of every login, logout, 111crash, shutdown and date change 112since 113.Pa utx.log 114was last truncated or 115created. 116.Pp 117If 118.Pa /var/log/utx.log 119is being used as the file, the user name may be empty 120or one of the special characters '|', '}' and '~'. 121Logouts produce 122an output line without any user name. 123For more information on the 124special characters, see 125.Xr getutxent 3 . 126.Sh ENVIRONMENT 127The 128.Ev COLUMNS , LANG , LC_ALL 129and 130.Ev LC_TIME 131environment variables affect the execution of 132.Nm 133as described in 134.Xr environ 7 . 135.Sh FILES 136.Bl -tag -width /var/log/utx.log.[0-6] -compact 137.It Pa /var/run/utx.active 138.It Pa /var/log/utx.log 139.It Pa /var/log/utx.log.[0-6] 140.El 141.Sh EXIT STATUS 142.Ex -std 143.Sh EXAMPLES 144Show a brief summary of who is logged in: 145.Bd -literal -offset indent 146$ who -q 147fernape root root 148# users = 3 149.Ed 150.Pp 151Show who is logged in along with the line and time fields (without the headers): 152.Bd -literal -offset indent 153$ who -s 154fernape ttyv0 Aug 26 16:23 155root ttyv1 Aug 26 16:23 156root ttyv2 Aug 26 16:23 157.Ed 158.Pp 159Show information about the terminal attached to standard input: 160.Bd -literal -offset indent 161$ who am i 162fernape Aug 26 16:24 163.Ed 164.Pp 165Show time and date of the last system reboot, whether the users accept messages 166and the idle time for each of them: 167.Bd -literal -offset indent 168$ who -a 169 - system boot Aug 26 16:23 . 170fernape - ttyv0 Aug 26 16:23 . 171root - ttyv1 Aug 26 16:23 . 172root - ttyv2 Aug 26 16:23 . 173.Ed 174.Pp 175Same as above but showing headers: 176.Bd -literal -offset indent 177$ who -aH 178NAME S LINE TIME IDLE FROM 179 - system boot Aug 26 16:23 . 180fernape - ttyv0 Aug 26 16:23 . 181root - ttyv1 Aug 26 16:23 00:01 182root - ttyv2 Aug 26 16:23 00:01 183.Ed 184.Sh SEE ALSO 185.Xr last 1 , 186.Xr users 1 , 187.Xr w 1 , 188.Xr getutxent 3 189.Sh STANDARDS 190The 191.Nm 192utility conforms to 193.St -p1003.1-2001 . 194.Sh HISTORY 195A 196.Nm 197command appeared in 198.At v1 . 199