Return to w.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/w.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)w.1 6.3 (Berkeley) 4/28/87
                      6: .\"
                      7: .TH W 1 "April 28, 1987"
                      8: .UC 4
                      9: .SH NAME
                     10: w \- who is on and what they are doing
                     11: .SH SYNOPSIS
                     12: .B w
                     13: [
                     14: .B \-hls
                     15: ] [ user ]
                     16: .SH DESCRIPTION
                     17: .I W
                     18: prints a summary of the current activity on the system,
                     19: including what each user is doing.
                     20: The heading line shows the current time of day,
                     21: how long the system has been up,
                     22: the number of users logged into the system,
                     23: and the load averages.
                     24: The load average numbers give the number of jobs in the run queue
                     25: averaged over 1, 5 and 15 minutes.
                     26: .PP
                     27: The fields output are:
                     28: the users login name,
                     29: the name of the tty the user is on,
                     30: the host from which the user is logged in,
                     31: the time the user logged on,
                     32: the time since the user last typed anything,
                     33: the CPU time used by all processes and their children on that terminal,
                     34: the CPU time used by the currently active processes,
                     35: the name and arguments of the current process.
                     36: .PP
                     37: The
                     38: .B \-h
                     39: flag suppresses the heading.
                     40: The
                     41: .B \-s
                     42: flag asks for a short form of output.
                     43: In the short form, the tty is abbreviated, the login time and cpu times
                     44: are left off, as are the arguments to commands.
                     45: .B \-l
                     46: gives the long output, which is the default.
                     47: The
                     48: .B \-f
                     49: option suppresses the ``from'' field.
                     50: .PP
                     51: If a
                     52: .I user
                     53: name is included,
                     54: the output will be restricted to that user.
                     55: .SH FILES
                     56: .ta 1i
                     57: /etc/utmp
                     58: .br
                     59: /dev/kmem
                     60: .br
                     61: /dev/drum
                     62: .SH "SEE ALSO"
                     63: who(1), finger(1), ps(1)
                     64: .SH AUTHOR
                     65: Mark Horton
                     66: .SH BUGS
                     67: The notion of the ``current process'' is muddy.
                     68: The current algorithm is ``the highest numbered process on
                     69: the terminal that is not ignoring interrupts,
                     70: or, if there is none, the highest numbered process on the terminal''.
                     71: This fails, for example, in critical sections of programs
                     72: like the shell and editor,
                     73: or when faulty programs running in the background
                     74: fork and fail to ignore interrupts.
                     75: (In cases where no process can be found,
                     76: .I w
                     77: prints ``\-''.)
                     78: .PP
                     79: The CPU time is only an estimate, in particular, if someone leaves a
                     80: background process running after logging out, the person currently
                     81: on that terminal is ``charged'' with the time.
                     82: .PP
                     83: Background processes are not shown, even though they account for
                     84: much of the load on the system.
                     85: .PP
                     86: Sometimes processes, typically those in the background, are
                     87: printed with null or garbaged arguments.
                     88: In these cases, the name of the command is printed in parentheses.
                     89: .PP
                     90: W does not know about the new conventions for detection of background jobs.
                     91: It will sometimes find a background job instead of the right one.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.