Return to w.1 CVS log

Up to [Research Unix] / researchv10dc / man / manb

Annotation of researchv10dc/man/manb/w.1, revision 1.1.1.1

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