xref: /csrg-svn/usr.bin/who/who.1 (revision 65227)
162446Sbostic.\" Copyright (c) 1986, 1991, 1993
262446Sbostic.\"	The Regents of the University of California.  All rights reserved.
319545Smckusick.\"
448601Scael.\" %sccs.include.redist.roff%
543756Scael.\"
6*65227Smckusick.\"     @(#)who.1	8.2 (Berkeley) 12/30/93
748333Sbostic.\"
848601Scael.Dd
948601Scael.Dt WHO 1
1048601Scael.Os
1148601Scael.Sh NAME
1248601Scael.Nm who
1348601Scael.Nd display who is logged in
1448601Scael.Sh SYNOPSIS
1548601Scael.Nm who
1648601Scael.Op Ar am I
1748601Scael.Op Ar file
1848601Scael.Sh DESCRIPTION
1948601ScaelThe utility
2048601Scael.Nm who
2148601Scaeldisplays
2248601Scaela list of all users currently logged on, showing for each user
2348601Scaelthe login name,
2448601Scaeltty name, the date and time of login, and hostname if not local.
2548601Scael.Pp
2648601ScaelAvailable options:
2748601Scael.Pp
2848601Scael.Bl -tag -width file
2948601Scael.It Ar \&am I
3048601ScaelReturns the invoker's real user name.
3148601Scael.It Ar file
3248601ScaelBy default,
3348601Scael.Nm who
3448601Scaelgathers information from the file
3548601Scael.Pa /var/run/utmp .
3648601ScaelAn alternate
3748601Scael.Ar file
3848601Scaelmay be specified which is usually
3948601Scael.Pa /var/run/wtmp
4048601Scael(or
4148601Scael.Pa /var/run/wtmp.[0-6]
4248601Scaeldepending on site policy as
4348601Scael.Pa wtmp
4448601Scaelcan grow quite large and daily versions may or may not
45*65227Smckusickbe kept around after compression by
4648601Scael.Xr ac 8 ) .
4748601ScaelThe
4848601Scael.Pa wtmp
4948601Scaelfile contains a record of every login, logout,
5048601Scaelcrash, shutdown and date change
5148601Scaelsince
5248601Scael.Pa wtmp
5348601Scaelwas last truncated or
5448601Scaelcreated.
5548601Scael.El
5648601Scael.Pp
5748601ScaelIf
5848601Scael.Pa /var/log/wtmp
5948601Scaelis being used as the file, the user name may be empty
6030283Sbosticor one of the special characters '|', '}' and '~'.  Logouts produce
6130283Sbostican output line without any user name.  For more information on the
6248601Scaelspecial characters, see
6348601Scael.Xr utmp 5 .
6448601Scael.Sh FILES
6548601Scael.Bl -tag -width /var/log/wtmp.[0-6] -compact
6648601Scael.It Pa /var/run/utmp
6748601Scael.It Pa /var/log/wtmp
6848601Scael.It Pa /var/log/wtmp.[0-6]
6948601Scael.El
7048601Scael.Sh SEE ALSO
7148601Scael.Xr last 1 ,
7248601Scael.Xr users 1 ,
7348601Scael.Xr getuid 2 ,
7448601Scael.Xr utmp 5
7548601Scael.Sh HISTORY
7648601ScaelA
7748601Scael.Nm
7848601Scaelcommand appeared in
7948601Scael.At v6 .
80