w.1

   1 .\"             -*-Nroff-*-
   2 .\"
   3 .TH W "1" "2020-06-04" "procps-ng" "User Commands"
   4 .SH NAME
   5 w \- Show who is logged on and what they are doing.
   6 .SH SYNOPSIS
   7 .B w
   8 [\fIoptions\fR] \fIuser\fR [...]
   9 .SH DESCRIPTION
  10 .B w
  11 displays information about the users currently on the machine, and their
  12 processes.  The header shows, in this order, the current time, how long the
  13 system has been running, how many users are currently logged on, and the
  14 system load averages for the past 1, 5, and 15 minutes.
  15 .PP
  16 The following entries are displayed for each user: login name, the tty name,
  17 the remote host, login time, idle time, JCPU, PCPU, and the command line of
  18 their current process.
  19 .PP
  20 The JCPU time is the time used by all processes attached to the tty.  It does
  21 not include past background jobs, but does include currently running
  22 background jobs.
  23 .PP
  24 The PCPU time is the time used by the current process, named in the "what"
  25 field.
  26 .SH "COMMAND\-LINE OPTIONS"
  27 .TP
  28 \fB\-h\fR, \fB\-\-no\-header\fR
  29 Don't print the header.
  30 .TP
  31 \fB\-u\fR, \fB\-\-no\-current\fR
  32 Ignores the username while figuring out the
  33 current process and cpu times.  To demonstrate this, do a
  34 .B su
  35 and do a
  36 .B w
  37 and a
  38 .BR "w \-u".
  39 .TP
  40 \fB\-s\fR, \fB\-\-short\fR
  41 Use the short format.  Don't print the login time, JCPU or PCPU times.
  42 .TP
  43 \fB\-f\fR, \fB\-\-from\fR
  44 Toggle printing the
  45 .B from
  46 (remote hostname) field.  The default as released is for the
  47 .B from
  48 field to not be printed, although your system administrator or distribution
  49 maintainer may have compiled a version in which the
  50 .B from
  51 field is shown by default.
  52 .TP
  53 \fB\-\-help\fR
  54 Display help text and exit.
  55 .TP
  56 \fB\-i\fR, \fB\-\-ip\-addr\fR
  57 Display IP address instead of hostname for \fBfrom\fR field.
  58 .TP
  59 \fB\-V\fR, \fB\-\-version\fR
  60 Display version information.
  61 .TP
  62 \fB\-o\fR, \fB\-\-old\-style\fR
  63 Old style output.  Prints blank space for idle times less than one minute.
  64 .TP
  65 .B "user "
  66 Show information about the specified user only.
  67 .SH ENVIRONMENT
  68 .TP
  69 PROCPS_USERLEN
  70 Override the default width of the username column.  Defaults to 8.
  71 .TP
  72 PROCPS_FROMLEN
  73 Override the default width of the from column.  Defaults to 16.
  74 .SH FILES
  75 .TP
  76 .I /var/run/utmp
  77 information about who is currently logged on
  78 .TP
  79 .I /proc
  80 process information
  81 .SH "SEE ALSO"
  82 .BR free (1),
  83 .BR ps (1),
  84 .BR top (1),
  85 .BR uptime (1),
  86 .BR utmp (5),
  87 .BR who (1)
  88 .SH AUTHORS
  89 .B w
  90 was re-written almost entirely by Charles Blake, based on the version by
  91 .UR greenfie@\:gauss.\:rutgers.\:edu
  92 Larry Greenfield
  93 .UE
  94 and
  95 .UR johnsonm@\:redhat.\:com
  96 Michael K. Johnson
  97 .UE
  98 .SH "REPORTING BUGS"
  99 Please send bug reports to
 100 .UR procps@freelists.org
 101 .UE