1.\" $NetBSD: who.1,v 1.24 2018/05/11 16:36:57 sevan Exp $ 2.\" 3.\" Copyright (c) 1986, 1991, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. Neither the name of the University nor the names of its contributors 15.\" may be used to endorse or promote products derived from this software 16.\" without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.\" @(#)who.1 8.2 (Berkeley) 12/30/93 31.\" 32.Dd May 11, 2018 33.Dt WHO 1 34.Os 35.Sh NAME 36.Nm who 37.Nd display who is logged in 38.Sh SYNOPSIS 39.Nm 40.Op Fl abdHlmqrsTtuv 41.Op Ar file 42.Nm 43.Ar am i 44.Sh DESCRIPTION 45The 46.Nm 47utility displays a list of all users currently logged on, showing for 48each user the login name, tty name, the date and time of login, and 49hostname if not local. 50.Pp 51Available options: 52.Bl -tag -width file 53.It Fl a 54Same as 55.Fl -bdlprTtuv . 56.It Fl b 57Time of last system boot. 58.It Fl d 59Print dead processes. 60.It Fl H 61Write column headings above the regular output. 62.It Fl l 63Print system login processes. 64.It Fl m 65Only print information about the current terminal. 66This is the POSIX way of saying 67.Nm 68.Ar am i . 69.It Fl p 70Print active processes spawned by 71.Xr init 8 . 72.It Fl q 73.Dq Quick mode : 74List only the names and the number of users currently logged on. 75When this option is used, all other options are ignored. 76.It Fl r 77Print the current runlevel. 78Supported runlevels are: 79.Bl -tag -width "s (SINGLE_USER)" 80.It Dv d Pq Dv DEATH 81The system has halted. 82.It Dv s Pq Dv SINGLE_USER 83The system is running in single user mode. 84.It Dv r Pq Dv RUNCOM 85The system is executing 86.Pa /etc/rc . 87.It Dv t Pq Dv READ_TTYS 88The system is processing 89.Pa /etc/ttys . 90.It Dv m Pq Dv MULTI_USER 91The system is running in multi-user mode. 92.It Dv T Pq Dv CLEAN_TTYS 93The system is in the process of stopping processes 94associated with terminal devices. 95.It Dv c Pq Dv CATATONIA 96The system is in the process of shutting down and will 97not create new processes. 98.El 99.It Fl s 100List only the name, line and time fields. 101This is the default. 102.It Fl T 103Print a character after the user name indicating the state of the 104terminal line: 105.Sq + 106if the terminal is writable; 107.Sq - 108if it is not; 109and 110.Sq \&? 111if a bad line is encountered. 112.It Fl t 113Print last system clock change. 114.It Fl u 115Print the idle time for each user, and the associated process ID. 116.It Fl v 117When printing of more information is requested with 118.Fl u , 119this switch can be used to also printed 120process termination signals, 121process exit status, 122session id for windowing 123and the type of the entry, see documentation of ut_type in 124.Xr getutxent 3 . 125.It Ar \&am I 126Returns the invoker's real user name. 127.It Ar file 128By default, 129.Nm 130gathers information from the file 131.Pa /var/run/utmpx . 132An alternative 133.Ar file 134may be specified which is usually 135.Pa /var/log/wtmpx 136(or 137.Pa /var/log/wtmp , 138or 139.Pa /var/log/wtmpx.[0-6] 140or 141.Pa /var/log/wtmp.[0-6] 142depending on site policy as 143.Pa wtmpx 144can grow quite large and daily versions may or may not 145be kept around after compression by 146.Xr ac 8 ) . 147The 148.Pa wtmpx 149and 150.Pa wtmp 151file contains a record of every login, logout, 152crash, shutdown and date change 153since 154.Pa wtmpx 155and 156.Pa wtmp 157were last truncated or 158created. 159.El 160.Pp 161If 162.Pa /var/log/wtmpx 163or 164.Pa /var/log/wtmp 165are being used as the file, the user name may be empty 166or one of the special characters '|', '}' and '~'. 167Logouts produce an output line without any user name. 168For more information on the 169special characters, see 170.Xr utmp 5 . 171.Sh FILES 172.Bl -tag -width /var/log/wtmp.[0-6] -compact 173.It Pa /var/run/utmp 174.It Pa /var/run/utmpx 175.It Pa /var/log/wtmp 176.It Pa /var/log/wtmp.[0-6] 177.It Pa /var/log/wtmpx 178.It Pa /var/log/wtmpx.[0-6] 179.El 180.Sh SEE ALSO 181.Xr last 1 , 182.Xr mesg 1 , 183.Xr users 1 , 184.Xr getuid 2 , 185.Xr utmp 5 , 186.Xr utmpx 5 187.Sh STANDARDS 188The 189.Nm 190utility is expected to conform to 191.St -p1003.2-92 . 192.Sh HISTORY 193A 194.Nm 195utility appeared in 196.At v1 : 197.Lk http://cm.bell-labs.com/cm/cs/who/dmr/pdfs/man14.pdf 198