=pod

=head1 NAME 

w - who is logged in, and what they are doing

=head1 SYNOPSIS

B<w>  (no options)

=head1 DESCRIPTION

This command displays a summary of system activity which is a combination of
the output from who and ps.  The output begins with a summary line showing
the current time, the uptime of the system, and the number of users logged on.

Following lines contain information about each user currently on the system,
including their username, which terminal they are connected to, the time of
day that the user logged on (in hours:minutes), how long they have been idle
(in hours:minutes), how much CPU time their current process has used (in
minutes:seconds), and what they are currently running.

=head1 EXAMPLE

01:22PM up 0 day(s),  0:02, 3 users.
 User     tty           login@  idle   CPU  what
 root     console      01:19PM  ?:??  0:00  ./w
 dfraser  ttyc1        01:21PM  ?:??  0:00  cat
 djikstra ttyc2        01:21PM  ?:??  0:10  ./timewaste

=head1 ERRORS
B<w> will return error messages if it doesn't have enough memory to allocate
internal structures, cannot read from F</dev/mem> or F</dev/kmem>, or cannot read
from F</etc/utmp>.

=head1 FILES
F</etc/utmp>

=head1 SEE ALSO
ps(1), who(1)

=head1 BUGS
The idle time feature currently does not work.

=head1 RESTRICTIONS
The idle time feature probably never will work.

=head1 AUTHOR
Dan J. Fraser <dfraser@mother.com>  (Student #1219229)
=cut