manpages: Remove some unneeded .Pp's.
[dragonfly.git] / usr.bin / who / who.1
CommitLineData
59a92d18
AH
1.\" $NetBSD: who.1,v 1.21 2007/01/17 16:37:41 christos Exp $
2.\"
984263bc
MD
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.
59a92d18 14.\" 3. Neither the name of the University nor the names of its contributors
984263bc
MD
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
984263bc 31.\"
59a92d18 32.Dd January 17, 2007
984263bc
MD
33.Dt WHO 1
34.Os
35.Sh NAME
36.Nm who
59a92d18 37.Nd display who is logged in
984263bc
MD
38.Sh SYNOPSIS
39.Nm
59a92d18 40.Op Fl abdHlmqrstTuv
984263bc 41.Op Ar file
59a92d18
AH
42.Nm
43.Ar am i
984263bc
MD
44.Sh DESCRIPTION
45The
46.Nm
59a92d18
AH
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:
59a92d18
AH
52.Bl -tag -width file
53.It Fl a
54Same as
55.Fl -bdlprTtuv .
7af85018 56.It Fl b
59a92d18
AH
57Time of last system boot.
58.It Fl d
59Print dead processes.
984263bc 60.It Fl H
59a92d18
AH
61Write column headings above the regular output.
62.It Fl l
63Print system login processes.
984263bc 64.It Fl m
59a92d18
AH
65Only print information about the current terminal.
66This is the
67.Tn POSIX
68way of saying
69.Nm
70.Ar am i .
71.It Fl p
72Print active processes spawned by
73.Xr init 8 .
984263bc 74.It Fl q
59a92d18
AH
75.Dq Quick mode :
76List only the names and the number of users currently logged on.
77When this option is used, all other options are ignored.
78.It Fl r
79Print the current runlevel.
80Supported runlevels are:
81.Bl -tag -width "s (SINGLE_USER)"
82.It Dv d Pq Dv DEATH
83The system has halted.
84.It Dv s Pq Dv SINGLE_USER
85The system is running in single user mode.
86.It Dv r Pq Dv RUNCOM
87The system is executing
88.Pa /etc/rc .
89.It Dv t Pq Dv READ_TTYS
90The system is processing
91.Pa /etc/ttys .
92.It Dv m Pq Dv MULTI_USER
93The system is running in multi-user mode.
94.It Dv T Pq Dv CLEAN_TTYS
95The system is in the process of stopping processes
96associated with terminal devices.
97.It Dv c Pq Dv CATATONIA
98The system is in the process of shutting down and will
99not create new processes.
100.El
984263bc 101.It Fl s
59a92d18 102List only the name, line and time fields.
984263bc
MD
103This is the default.
104.It Fl T
59a92d18
AH
105Print a character after the user name indicating the state of the
106terminal line:
107.Sq +
108if the terminal is writable;
109.Sq -
110if it is not;
111and
112.Sq \&?
113if a bad line is encountered.
114.It Fl t
115Print last system clock change.
984263bc 116.It Fl u
59a92d18
AH
117Print the idle time for each user, and the associated process ID.
118.It Fl v
119When printing of more information is requested with
120.Fl u ,
121this switch can be used to also printed
122process termination signals,
123process exit status,
124session id for windowing
125and the type of the entry, see documentation of ut_type in
126.Xr getutxent 3 .
127.It Ar \&am I
128Returns the invoker's real user name.
129.It Ar file
984263bc
MD
130By default,
131.Nm
132gathers information from the file
59a92d18
AH
133.Pa /var/run/utmpx .
134An alternative
984263bc
MD
135.Ar file
136may be specified which is usually
59a92d18 137.Pa /var/log/wtmpx
984263bc 138(or
59a92d18
AH
139.Pa /var/log/wtmp ,
140or
141.Pa /var/log/wtmpx.[0-6]
142or
984263bc
MD
143.Pa /var/log/wtmp.[0-6]
144depending on site policy as
59a92d18 145.Pa wtmpx
984263bc
MD
146can grow quite large and daily versions may or may not
147be kept around after compression by
148.Xr ac 8 ) .
149The
59a92d18
AH
150.Pa wtmpx
151and
984263bc
MD
152.Pa wtmp
153file contains a record of every login, logout,
154crash, shutdown and date change
155since
59a92d18
AH
156.Pa wtmpx
157and
984263bc 158.Pa wtmp
59a92d18 159were last truncated or
984263bc 160created.
59a92d18 161.El
984263bc
MD
162.Pp
163If
59a92d18
AH
164.Pa /var/log/wtmpx
165or
984263bc 166.Pa /var/log/wtmp
59a92d18
AH
167are being used as the file, the user name may be empty
168or one of the special characters '|', '}' and '~'.
169Logouts produce an output line without any user name.
170For more information on the
984263bc
MD
171special characters, see
172.Xr utmp 5 .
984263bc
MD
173.Sh FILES
174.Bl -tag -width /var/log/wtmp.[0-6] -compact
175.It Pa /var/run/utmp
59a92d18 176.It Pa /var/run/utmpx
984263bc
MD
177.It Pa /var/log/wtmp
178.It Pa /var/log/wtmp.[0-6]
59a92d18
AH
179.It Pa /var/log/wtmpx
180.It Pa /var/log/wtmpx.[0-6]
984263bc 181.El
984263bc
MD
182.Sh SEE ALSO
183.Xr last 1 ,
59a92d18 184.Xr mesg 1 ,
984263bc 185.Xr users 1 ,
59a92d18
AH
186.Xr getuid 2 ,
187.Xr utmp 5 ,
188.Xr utmpx 5
984263bc
MD
189.Sh STANDARDS
190The
191.Nm
59a92d18
AH
192utility is expected to conform to
193.St -p1003.2-92 .
984263bc
MD
194.Sh HISTORY
195A
196.Nm
59a92d18
AH
197utility appeared in
198.At v6 .