.\"
.\" Copyright (c) 2009-2023 Craig Small <csmall@dropbear.xyz>
.\" Copyright (c) 2015-2023 Jim Warner <james.warner@comcast.net>
.\" Copyright (c) 2012-2013 Jaromir Capik <jcapik@redhat.com>
.\" Copyright (c) 2011-2012 Sami Kerola <kerolasa@iki.fi>
.\" Copyright (c) 2002-2004 Albert Cahalan
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\"
.TH W "1" "2023-01-15" "procps-ng" "User Commands"
.SH NAME
w \- Show who is logged on and what they are doing.
.SH SYNOPSIS
.B w
[\fIoptions\fR] [\fIuser\fR]
.SH DESCRIPTION
.B w
displays information about the users currently on the machine, and their
processes.  The header shows, in this order, the current time, how long the
system has been running, how many users are currently logged on, and the
system load averages for the past 1, 5, and 15 minutes.
.PP
The following entries are displayed for each user: login name, the tty name,
the remote host, login time, idle time, JCPU, PCPU, and the command line of
their current process.
.PP
The JCPU time is the time used by all processes attached to the tty.  It does
not include past background jobs, but does include currently running
background jobs.
.PP
The PCPU time is the time used by the current process, named in the "what"
field.
.SH "COMMAND\-LINE OPTIONS"
.TP
\fB\-h\fR, \fB\-\-no\-header\fR
Don't print the header.
.TP
\fB\-u\fR, \fB\-\-no\-current\fR
Ignores the username while figuring out the
current process and cpu times.  To demonstrate this, do a
.B su
and do a
.B w
and a
.BR "w \-u".
.TP
\fB\-s\fR, \fB\-\-short\fR
Use the short format.  Don't print the login time, JCPU or PCPU times.
.TP
\fB\-t\fR, \fB\-\-terminal\fR
Usually
.B w
will use either the systemd sessions table or the utmp file to locate users.
In \fIterminal mode\fR
.B w
will scan the terminal devices and locate user sessions this way. This is not
a true count of users, for example a user with two xterms will show up twice,
so the user count in the header will be different. Currently terminal devices
scanned are \fI/dev/tty*\fR and \fI/dev/pts/*\fR.
.TP
\fB\-f\fR, \fB\-\-from\fR
Toggle printing the
.B from
(remote hostname) field.  The default as released is for the
.B from
field to not be printed, although your system administrator or distribution
maintainer may have compiled a version in which the
.B from
field is shown by default.
.TP
\fB\-\-help\fR
Display help text and exit.
.TP
\fB\-i\fR, \fB\-\-ip\-addr\fR
Display IP address instead of hostname for \fBfrom\fR field.
.TP
\fB\-p\fR, \fB\-\-pids\fR
Display pid of the login process/the "what" process in the "what" field.
The login process is also called the session leader.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version information.
.TP
\fB\-o\fR, \fB\-\-old\-style\fR
Old style output.  Prints blank space for idle times less than one minute.
.TP
.B "user "
Show information about the specified user only.
.SH ENVIRONMENT
.TP
PROCPS_USERLEN
Override the default width of the username column.  Defaults to 8.
.TP
PROCPS_FROMLEN
Override the default width of the from column.  Defaults to 16.
.SH FILES
.TP
.I /var/run/utmp
information about who is currently logged on, only for non-systemd hosts.
.TP
.I /proc
process information
.TP
.IR /dev/tty* " , " /dev/pts/*
Terminal device files scanned with \fB\-\-terminal\fR mode.
.SH BUGS
When using \fB\-\-terminal\fP option,
.B w
assumes processes with a parent PID of 0 or 1 are
.BR agetty (8)
processes and will not display them. This is prone to both false postive
and negative errors.
.SH REPORTING BUGS
Please send bug reports to
.MT procps@freelists.org
.ME
.SH SEE ALSO
.BR free (1),
.BR loginctl (1),
.BR ps (1),
.BR top (1),
.BR uptime (1),
.BR who (1),
.BR utmp (5),
.BR agetty (8)