mirror of
https://gitlab.com/procps-ng/procps.git
synced 2024-11-30 21:44:05 +08:00
4c31bb49e5
This commit is an outgrowth of the research into a bug involving the recently added enum 'PROCPS_PIDS_extra'. Since this program is not equipped to filter more than one user, the help text and man document were updated. Signed-off-by: Jim Warner <james.warner@comcast.net>
98 lines
2.6 KiB
Groff
98 lines
2.6 KiB
Groff
.\" -*-Nroff-*-
|
|
.\"
|
|
.TH W "1" "September 2015" "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 "su" and do a "w"
|
|
and a "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\-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\-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
|
|
.TP
|
|
.I /proc
|
|
process information
|
|
.SH "SEE ALSO"
|
|
.BR free (1),
|
|
.BR ps (1),
|
|
.BR top (1),
|
|
.BR uptime (1),
|
|
.BR utmp (5),
|
|
.BR who (1)
|
|
.SH AUTHORS
|
|
.B w
|
|
was re-written almost entirely by Charles Blake, based on the version by
|
|
.UR greenfie@\:gauss.\:rutgers.\:edu
|
|
Larry Greenfield
|
|
.UE
|
|
and
|
|
.UR johnsonm@\:redhat.\:com
|
|
Michael K. Johnson
|
|
.UE
|
|
.SH "REPORTING BUGS"
|
|
Please send bug reports to
|
|
.UR procps@freelists.org
|
|
.UE
|