Commit | Line | Data |
---|---|---|
89124ab1 KM |
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 | .\" | |
b5195d27 | 5 | .\" @(#)w.1 6.3 (Berkeley) %G% |
89124ab1 | 6 | .\" |
2c1ecc2d | 7 | .TH W 1 "" |
89124ab1 KM |
8 | .UC 4 |
9 | .SH NAME | |
10 | w \- who is on and what they are doing | |
11 | .SH SYNOPSIS | |
12 | .B w | |
13 | [ | |
b5195d27 | 14 | .B \-hls |
89124ab1 KM |
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, | |
c4d62da1 MK |
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, | |
89124ab1 KM |
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. | |
c4d62da1 MK |
47 | The |
48 | .B \-f | |
49 | option suppresses the ``from'' field. | |
89124ab1 KM |
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. |