xref: /freebsd/usr.bin/who/who.1 (revision c3aac50f284c6cca5b4f2eb46aaa13812cb8b630)
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.\"
359b50d902SRodney W. Grimes.Dd December 30, 1993
369b50d902SRodney W. Grimes.Dt WHO 1
379b50d902SRodney W. Grimes.Os
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm who
409b50d902SRodney W. Grimes.Nd display who is logged in
419b50d902SRodney W. Grimes.Sh SYNOPSIS
429b50d902SRodney W. Grimes.Nm who
43acf1dcdcSPoul-Henning Kamp.Ar am I
44acf1dcdcSPoul-Henning Kamp.Nm who
459b50d902SRodney W. Grimes.Op Ar file
469b50d902SRodney W. Grimes.Sh DESCRIPTION
470abcff76SPhilippe CharnierThe
480abcff76SPhilippe Charnier.Nm
490abcff76SPhilippe Charnierutility displays
509b50d902SRodney W. Grimesa list of all users currently logged on, showing for each user
519b50d902SRodney W. Grimesthe login name,
529b50d902SRodney W. Grimestty name, the date and time of login, and hostname if not local.
539b50d902SRodney W. Grimes.Pp
549b50d902SRodney W. GrimesAvailable options:
559b50d902SRodney W. Grimes.Pp
569b50d902SRodney W. Grimes.Bl -tag -width file
579b50d902SRodney W. Grimes.It Ar \&am I
589b50d902SRodney W. GrimesReturns the invoker's real user name.
599b50d902SRodney W. Grimes.It Ar file
609b50d902SRodney W. GrimesBy default,
610abcff76SPhilippe Charnier.Nm
629b50d902SRodney W. Grimesgathers information from the file
639b50d902SRodney W. Grimes.Pa /var/run/utmp .
649b50d902SRodney W. GrimesAn alternate
659b50d902SRodney W. Grimes.Ar file
669b50d902SRodney W. Grimesmay be specified which is usually
679b50d902SRodney W. Grimes.Pa /var/run/wtmp
689b50d902SRodney W. Grimes(or
699b50d902SRodney W. Grimes.Pa /var/run/wtmp.[0-6]
709b50d902SRodney W. Grimesdepending on site policy as
719b50d902SRodney W. Grimes.Pa wtmp
729b50d902SRodney W. Grimescan grow quite large and daily versions may or may not
739b50d902SRodney W. Grimesbe kept around after compression by
749b50d902SRodney W. Grimes.Xr ac 8 ) .
759b50d902SRodney W. GrimesThe
769b50d902SRodney W. Grimes.Pa wtmp
779b50d902SRodney W. Grimesfile contains a record of every login, logout,
789b50d902SRodney W. Grimescrash, shutdown and date change
799b50d902SRodney W. Grimessince
809b50d902SRodney W. Grimes.Pa wtmp
819b50d902SRodney W. Grimeswas last truncated or
829b50d902SRodney W. Grimescreated.
839b50d902SRodney W. Grimes.El
849b50d902SRodney W. Grimes.Pp
859b50d902SRodney W. GrimesIf
869b50d902SRodney W. Grimes.Pa /var/log/wtmp
879b50d902SRodney W. Grimesis being used as the file, the user name may be empty
889b50d902SRodney W. Grimesor one of the special characters '|', '}' and '~'.  Logouts produce
899b50d902SRodney W. Grimesan output line without any user name.  For more information on the
909b50d902SRodney W. Grimesspecial characters, see
919b50d902SRodney W. Grimes.Xr utmp 5 .
929b50d902SRodney W. Grimes.Sh FILES
939b50d902SRodney W. Grimes.Bl -tag -width /var/log/wtmp.[0-6] -compact
949b50d902SRodney W. Grimes.It Pa /var/run/utmp
959b50d902SRodney W. Grimes.It Pa /var/log/wtmp
969b50d902SRodney W. Grimes.It Pa /var/log/wtmp.[0-6]
979b50d902SRodney W. Grimes.El
989b50d902SRodney W. Grimes.Sh SEE ALSO
999b50d902SRodney W. Grimes.Xr last 1 ,
1009b50d902SRodney W. Grimes.Xr users 1 ,
1019b50d902SRodney W. Grimes.Xr getuid 2 ,
1029b50d902SRodney W. Grimes.Xr utmp 5
1039b50d902SRodney W. Grimes.Sh HISTORY
1049b50d902SRodney W. GrimesA
1059b50d902SRodney W. Grimes.Nm
1069b50d902SRodney W. Grimescommand appeared in
107b8923d4cSWolfram Schneider.At v1 .
108