xref: /freebsd/usr.bin/w/w.1 (revision ac3cd5208b01265025fc20ca2425719ad8da2ddc)
19b50d902SRodney W. Grimes.\" Copyright (c) 1980, 1990, 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.\"     @(#)w.1	8.1 (Berkeley) 6/6/93
33ac3cd520SBrian Feldman.\"	$Id: w.1,v 1.10 1998/03/22 17:39:08 steve Exp $
349b50d902SRodney W. Grimes.\"
359b50d902SRodney W. Grimes.Dd June 6, 1993
369b50d902SRodney W. Grimes.Dt W 1
379b50d902SRodney W. Grimes.Os BSD 4
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm w
40a76f1729SSteve Price.Nd "display who is logged in and what they are doing"
419b50d902SRodney W. Grimes.Sh SYNOPSIS
429b50d902SRodney W. Grimes.Nm w
437860b557SAndrey A. Chernov.Op Fl dhin
449b50d902SRodney W. Grimes.Op Fl M Ar core
459b50d902SRodney W. Grimes.Op Fl N Ar system
46ac3cd520SBrian Feldman.Op Ar user ...
479b50d902SRodney W. Grimes.Sh DESCRIPTION
489b50d902SRodney W. GrimesThe
4990389da9SPhilippe Charnier.Nm
509b50d902SRodney W. Grimesutility prints a summary of the current activity on the system,
519b50d902SRodney W. Grimesincluding what each user is doing.
529b50d902SRodney W. GrimesThe first line displays the current time of day, how long the system has
539b50d902SRodney W. Grimesbeen running, the number of users logged into the system, and the load
549b50d902SRodney W. Grimesaverages.
559b50d902SRodney W. GrimesThe load average numbers give the number of jobs in the run queue averaged
569b50d902SRodney W. Grimesover 1, 5 and 15 minutes.
579b50d902SRodney W. Grimes.Pp
589b50d902SRodney W. GrimesThe fields output are the user's login name, the name of the terminal the
599b50d902SRodney W. Grimesuser is on, the host from which the user is logged in, the time the user
609b50d902SRodney W. Grimeslogged on, the time since the user last typed anything,
619b50d902SRodney W. Grimesand the name and arguments of the current process.
629b50d902SRodney W. Grimes.Pp
639b50d902SRodney W. GrimesThe options are as follows:
649b50d902SRodney W. Grimes.Bl -tag -width Ds
657860b557SAndrey A. Chernov.It Fl d
667860b557SAndrey A. Chernovdumps out the entire process list on a per controlling
677860b557SAndrey A. Chernovtty basis, instead of just the top level process.
689b50d902SRodney W. Grimes.It Fl h
699b50d902SRodney W. GrimesSuppress the heading.
709b50d902SRodney W. Grimes.It Fl i
719b50d902SRodney W. GrimesOutput is sorted by idle time.
729b50d902SRodney W. Grimes.It Fl M
739b50d902SRodney W. GrimesExtract values associated with the name list from the specified
749b50d902SRodney W. Grimescore instead of the default
759b50d902SRodney W. Grimes.Dq /dev/kmem .
769b50d902SRodney W. Grimes.It Fl N
779b50d902SRodney W. GrimesExtract the name list from the specified system instead of the
789b50d902SRodney W. Grimesdefault
79b3bfc719SDavid Greenman.Dq /kernel .
809b50d902SRodney W. Grimes.It Fl n
819b50d902SRodney W. GrimesShow network addresses as numbers (normally
8290389da9SPhilippe Charnier.Nm
839b50d902SRodney W. Grimesinterprets addresses and attempts to display them symbolically).
849b50d902SRodney W. Grimes.El
859b50d902SRodney W. Grimes.Pp
86ac3cd520SBrian FeldmanIf one or more
879b50d902SRodney W. Grimes.Ar user
88ac3cd520SBrian Feldmannames are specified, the output is restricted to those users.
899b50d902SRodney W. Grimes.Sh FILES
909b50d902SRodney W. Grimes.Bl -tag -width /var/run/utmp -compact
919b50d902SRodney W. Grimes.It Pa /var/run/utmp
929b50d902SRodney W. Grimeslist of users on the system
939b50d902SRodney W. Grimes.El
949b50d902SRodney W. Grimes.Sh SEE ALSO
959b50d902SRodney W. Grimes.Xr finger 1 ,
969b50d902SRodney W. Grimes.Xr ps 1 ,
97da1ff3cbSWolfram Schneider.Xr uptime 1 ,
98da1ff3cbSWolfram Schneider.Xr who 1
999b50d902SRodney W. Grimes.Sh BUGS
1009b50d902SRodney W. GrimesThe notion of the
1019b50d902SRodney W. Grimes.Dq current process
1029b50d902SRodney W. Grimesis muddy.
1039b50d902SRodney W. GrimesThe current algorithm is ``the highest numbered process on the terminal
1049b50d902SRodney W. Grimesthat is not ignoring interrupts, or, if there is none, the highest numbered
1059b50d902SRodney W. Grimesprocess on the terminal''.
1069b50d902SRodney W. GrimesThis fails, for example, in critical sections of programs like the shell
1079b50d902SRodney W. Grimesand editor, or when faulty programs running in the background fork and fail
1089b50d902SRodney W. Grimesto ignore interrupts.
1099b50d902SRodney W. Grimes(In cases where no process can be found,
11090389da9SPhilippe Charnier.Nm
1119b50d902SRodney W. Grimesprints
1129b50d902SRodney W. Grimes.Dq \- . )
1139b50d902SRodney W. Grimes.Pp
1149b50d902SRodney W. GrimesThe
1159b50d902SRodney W. Grimes.Tn CPU
1169b50d902SRodney W. Grimestime is only an estimate, in particular, if someone leaves a background
1179b50d902SRodney W. Grimesprocess running after logging out, the person currently on that terminal is
1189b50d902SRodney W. Grimes.Dq charged
1199b50d902SRodney W. Grimeswith the time.
1209b50d902SRodney W. Grimes.Pp
1219b50d902SRodney W. GrimesBackground processes are not shown, even though they account for
1229b50d902SRodney W. Grimesmuch of the load on the system.
1239b50d902SRodney W. Grimes.Pp
1249b50d902SRodney W. GrimesSometimes processes, typically those in the background, are printed with
1259b50d902SRodney W. Grimesnull or garbaged arguments.
1269b50d902SRodney W. GrimesIn these cases, the name of the command is printed in parentheses.
1279b50d902SRodney W. Grimes.Pp
1289b50d902SRodney W. GrimesThe
12990389da9SPhilippe Charnier.Nm
1309b50d902SRodney W. Grimesutility does not know about the new conventions for detection of background
1319b50d902SRodney W. Grimesjobs.
1329b50d902SRodney W. GrimesIt will sometimes find a background job instead of the right one.
1339b50d902SRodney W. Grimes.Sh COMPATIBILITY
1349b50d902SRodney W. GrimesThe
1359b50d902SRodney W. Grimes.Fl f ,
1369b50d902SRodney W. Grimes.Fl l ,
1379b50d902SRodney W. Grimes.Fl s ,
1389b50d902SRodney W. Grimesand
1399b50d902SRodney W. Grimes.Fl w
1409b50d902SRodney W. Grimesflags are no longer supported.
1419b50d902SRodney W. Grimes.Sh HISTORY
1429b50d902SRodney W. GrimesThe
1439b50d902SRodney W. Grimes.Nm
1449b50d902SRodney W. Grimescommand appeared in
1459b50d902SRodney W. Grimes.Ux 3.0 .
146