diff options
Diffstat (limited to 'usr.bin/who/who.1')
-rw-r--r-- | usr.bin/who/who.1 | 105 |
1 files changed, 105 insertions, 0 deletions
diff --git a/usr.bin/who/who.1 b/usr.bin/who/who.1 new file mode 100644 index 0000000..f8ac307 --- /dev/null +++ b/usr.bin/who/who.1 @@ -0,0 +1,105 @@ +.\" Copyright (c) 1986, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)who.1 8.2 (Berkeley) 12/30/93 +.\" +.Dd December 30, 1993 +.Dt WHO 1 +.Os +.Sh NAME +.Nm who +.Nd display who is logged in +.Sh SYNOPSIS +.Nm who +.Op Ar am I +.Op Ar file +.Sh DESCRIPTION +The utility +.Nm who +displays +a list of all users currently logged on, showing for each user +the login name, +tty name, the date and time of login, and hostname if not local. +.Pp +Available options: +.Pp +.Bl -tag -width file +.It Ar \&am I +Returns the invoker's real user name. +.It Ar file +By default, +.Nm who +gathers information from the file +.Pa /var/run/utmp . +An alternate +.Ar file +may be specified which is usually +.Pa /var/run/wtmp +(or +.Pa /var/run/wtmp.[0-6] +depending on site policy as +.Pa wtmp +can grow quite large and daily versions may or may not +be kept around after compression by +.Xr ac 8 ) . +The +.Pa wtmp +file contains a record of every login, logout, +crash, shutdown and date change +since +.Pa wtmp +was last truncated or +created. +.El +.Pp +If +.Pa /var/log/wtmp +is being used as the file, the user name may be empty +or one of the special characters '|', '}' and '~'. Logouts produce +an output line without any user name. For more information on the +special characters, see +.Xr utmp 5 . +.Sh FILES +.Bl -tag -width /var/log/wtmp.[0-6] -compact +.It Pa /var/run/utmp +.It Pa /var/log/wtmp +.It Pa /var/log/wtmp.[0-6] +.El +.Sh SEE ALSO +.Xr last 1 , +.Xr users 1 , +.Xr getuid 2 , +.Xr utmp 5 +.Sh HISTORY +A +.Nm +command appeared in +.At v6 . |