xref: /freebsd/usr.bin/who/who.1 (revision 38a999420103f16fc0636a1e1f123e42fb26f1d1)
19b50d902SRodney W. Grimes.\" Copyright (c) 1986, 1991, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"     @(#)who.1	8.2 (Berkeley) 12/30/93
33c3aac50fSPeter Wemm.\" $FreeBSD$
349b50d902SRodney W. Grimes.\"
3538a99942STim J. Robbins.Dd May 8, 2002
369b50d902SRodney W. Grimes.Dt WHO 1
379b50d902SRodney W. Grimes.Os
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm who
4038a99942STim J. Robbins.Nd display who is on the system
419b50d902SRodney W. Grimes.Sh SYNOPSIS
428fe908efSRuslan Ermilov.Nm
4338a99942STim J. Robbins.Op Fl HmqsTu
4438a99942STim J. Robbins.Op Cm am I
459b50d902SRodney W. Grimes.Op Ar file
469b50d902SRodney W. Grimes.Sh DESCRIPTION
470abcff76SPhilippe CharnierThe
480abcff76SPhilippe Charnier.Nm
4938a99942STim J. Robbinsutility displays information about currently logged in users.
5038a99942STim J. RobbinsBy default, this includes the login name, tty name, date and time of login and
5138a99942STim J. Robbinsremote hostname if not local.
529b50d902SRodney W. Grimes.Pp
5338a99942STim J. RobbinsThe options are as follows:
5438a99942STim J. Robbins.Bl -tag -width indent
5538a99942STim J. Robbins.It Fl H
5638a99942STim J. RobbinsWrite column headings above the output.
5738a99942STim J. Robbins.It Fl m
5838a99942STim J. RobbinsShow information about the terminal attached to standard input only.
5938a99942STim J. Robbins.It Fl q
6038a99942STim J. Robbins.Dq Quick mode Ns :
6138a99942STim J. RobbinsList the names and number of logged in users in columns.
6238a99942STim J. RobbinsAll other command line options are ignored.
6338a99942STim J. Robbins.It Fl s
6438a99942STim J. RobbinsShow the name, line and time fields only.
6538a99942STim J. RobbinsThis is the default.
6638a99942STim J. Robbins.It Fl T
6738a99942STim J. RobbinsIndicate whether each user is accepting messages.
6838a99942STim J. RobbinsOne of the following characters is written:
6938a99942STim J. Robbins.Bl -tag -width x -compact
7038a99942STim J. Robbins.It +
7138a99942STim J. RobbinsUser is accepting messages.
7238a99942STim J. Robbins.It \&-
7338a99942STim J. RobbinsUser is not accepting messages.
7438a99942STim J. Robbins.It ?
7538a99942STim J. RobbinsAn error occurred.
7638a99942STim J. Robbins.El
7738a99942STim J. Robbins.It Fl u
7838a99942STim J. RobbinsShow idle time for each user in hours and minutes as
7938a99942STim J. Robbins.Ql hh:mm ,
8038a99942STim J. Robbins.Ql \&.
8138a99942STim J. Robbinsif the user has been idle less that a minute and
8238a99942STim J. Robbins.Ql old
8338a99942STim J. Robbinsif the user has been idle more than 24 hours.
8438a99942STim J. Robbins.It Cm am I
8538a99942STim J. RobbinsEquivalent to
8638a99942STim J. Robbins.Fl m .
8738a99942STim J. Robbins.El
889b50d902SRodney W. Grimes.Pp
899b50d902SRodney W. GrimesBy default,
900abcff76SPhilippe Charnier.Nm
919b50d902SRodney W. Grimesgathers information from the file
929b50d902SRodney W. Grimes.Pa /var/run/utmp .
939b50d902SRodney W. GrimesAn alternate
949b50d902SRodney W. Grimes.Ar file
959b50d902SRodney W. Grimesmay be specified which is usually
961807222dSDima Dorfman.Pa /var/log/wtmp
979b50d902SRodney W. Grimes(or
981807222dSDima Dorfman.Pa /var/log/wtmp.[0-6]
999b50d902SRodney W. Grimesdepending on site policy as
1009b50d902SRodney W. Grimes.Pa wtmp
1019b50d902SRodney W. Grimescan grow quite large and daily versions may or may not
1029b50d902SRodney W. Grimesbe kept around after compression by
1039b50d902SRodney W. Grimes.Xr ac 8 ) .
1049b50d902SRodney W. GrimesThe
1059b50d902SRodney W. Grimes.Pa wtmp
1069b50d902SRodney W. Grimesfile contains a record of every login, logout,
1079b50d902SRodney W. Grimescrash, shutdown and date change
1089b50d902SRodney W. Grimessince
1099b50d902SRodney W. Grimes.Pa wtmp
1109b50d902SRodney W. Grimeswas last truncated or
1119b50d902SRodney W. Grimescreated.
1129b50d902SRodney W. Grimes.Pp
1139b50d902SRodney W. GrimesIf
1149b50d902SRodney W. Grimes.Pa /var/log/wtmp
1159b50d902SRodney W. Grimesis being used as the file, the user name may be empty
1169b50d902SRodney W. Grimesor one of the special characters '|', '}' and '~'.  Logouts produce
1179b50d902SRodney W. Grimesan output line without any user name.  For more information on the
1189b50d902SRodney W. Grimesspecial characters, see
1199b50d902SRodney W. Grimes.Xr utmp 5 .
1209b50d902SRodney W. Grimes.Sh FILES
1219b50d902SRodney W. Grimes.Bl -tag -width /var/log/wtmp.[0-6] -compact
1229b50d902SRodney W. Grimes.It Pa /var/run/utmp
1239b50d902SRodney W. Grimes.It Pa /var/log/wtmp
1249b50d902SRodney W. Grimes.It Pa /var/log/wtmp.[0-6]
1259b50d902SRodney W. Grimes.El
12638a99942STim J. Robbins.Sh DIAGNOSTICS
12738a99942STim J. Robbins.Ex -std
1289b50d902SRodney W. Grimes.Sh SEE ALSO
1299b50d902SRodney W. Grimes.Xr last 1 ,
1309b50d902SRodney W. Grimes.Xr users 1 ,
13138a99942STim J. Robbins.Xr w 1 ,
1329b50d902SRodney W. Grimes.Xr utmp 5
13338a99942STim J. Robbins.Sh STANDARDS
13438a99942STim J. RobbinsThe
13538a99942STim J. Robbins.Nm
13638a99942STim J. Robbinsutility conforms to
13738a99942STim J. Robbins.St -p1003.1-2001 .
1389b50d902SRodney W. Grimes.Sh HISTORY
1399b50d902SRodney W. GrimesA
1409b50d902SRodney W. Grimes.Nm
1419b50d902SRodney W. Grimescommand appeared in
142b8923d4cSWolfram Schneider.At v1 .
143