w(C)                            19 June 1992                            w(C)


 Name

    w - display information about who is on the system and what they are
    doing

 Syntax

    w [ -hlqtw ] [ -n namelist ] [ -s swapdev ] [ -u utmpfile ] [ users ... ]

 Description

    The w command prints a summary of the current activity on the system,
    including what each user is doing.  The heading line shows the current
    time of day, how long the system has been up, the number of users logged
    onto the system, and load averages.  Load averages are the number of pro-
    cesses in the run queue averaged over 1, 5, and 15 minutes.

    The options are:

    -h          Do not print the heading or title lines.

    -l          Long format (default): for each user, w outputs the user's
                login name, the terminal or pseudo terminal the user is
                currently using, when the user logged onto the system, the
                number of minutes the user has been idle (how much time has
                expired since the user last typed anything), the CPU time
                used by all processes and their children attached to the ter-
                minal, the CPU time used by the currently active process, and
                the name and arguments of the currently active process.

    -q          Quick format: for each user, w outputs the user's login name,
                the terminal or pseudo terminal the user is currently using,
                the number of minutes the user has been idle, and the name of
                the currently active process.

    -t          Only the heading line is output (equivalent to uptime(C)).

    -w          Both the heading line and the summary of users is output.

    -nnamelist  The argument is taken as the name of an alternate namelist
                (/unix is the default).

    -sswapdev   Uses the file swapdev in place of /dev/swap.  This is useful
                when examining a corefile.

    -uutmpfile  The file utmpfile is used instead of /etc/utmp as a record of
                who is currently logged in.

    If any users are given, the user summary is restricted to reporting on
    those users.

 Files

    /unix
    /etc/utmp
    /dev/kmem
    /dev/swap

 See also

    date(C), finger(C), ps(C), uptime(C), who(C), whodo(C)

 Notes

    The ``currently active process'' is only an approximation and is not
    always correct.  Pipelines can produce strange results, as can some back-
    ground processes.  If w is completely unable to guess at the currently
    active process, it prints ``-''.

 Authorization

    The behavior of this utility is affected by assignment of the mem author-
    ization, which is usually reserved for system administrators.  If you do
    not have this authorization, the output will be restricted to data per-
    taining to your activities only.  Refer to the ``Using a secure system''
    chapter of the User's Guide for more details.

 Value added

    w is an extension of AT&T System V provided by The Santa Cruz Operation,
    Inc.