emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

docs: mention long options in man w.1

Browse Source 
The commit includes few generic manual clean ups as well.

Signed-off-by: Sami Kerola <kerolasa@iki.fi>
This commit is contained in:
Sami Kerola
2011-06-06 22:53:59 +02:00
parent 35c8459c47
commit 3fc07c1068
1 changed files with 53 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files

107
w.1
View File

@ -1,74 +1,69 @@
.\" -*-Nroff-*- .\" -*-Nroff-*-
.\" .\"
.TH W 1 "5 October 2009 " " " "Linux User's Manual" .TH W "1" "June 2011" "procps-ng" "User Commands"
.SH NAME .SH NAME
w \- Show who is logged on and what they are doing. w \- Show who is logged on and what they are doing.
.SH SYNOPSIS .SH SYNOPSIS
.B w .B w
.RB [ \-husfV- ] [\fIoptions\fR] \fIuser\fR [...]
.RI [ user ]
.SH DESCRIPTION .SH DESCRIPTION
.B w .B w
displays information about the users currently on the machine, displays information about the users currently on the machine, and their
and their processes. processes. The header shows, in this order, the current time, how long the
The header shows, in this order, the current time, system has been running, how many users are currently logged on, and the
how long the system has been running, system load averages for the past 1, 5, and 15 minutes.
how many users are currently logged on, .PP
and the system load averages for the past 1, 5, and 15 minutes. 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
The following entries are displayed for each user: their current process.
login name, the tty name, the remote host, login time, idle time, JCPU, PCPU, .PP
and the command line of their current process. 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
The JCPU time is the time used by all processes attached to the tty. It background jobs.
does not include past background jobs, but does include currently .PP
running background jobs.
The PCPU time is the time used by the current process, named in the "what" The PCPU time is the time used by the current process, named in the "what"
field. field.
.PP
.SH "COMMAND\-LINE OPTIONS" .SH "COMMAND\-LINE OPTIONS"
.TP 0.5i .TP
.B "\-h " \fB\-h\fR, \fB\-\-no\-header\fR
Don't print the header. Don't print the header.
.TP 0.5i .TP
.B "\-u " \fB\-u\fR, \fB\-\-no\-current\fR
Ignores the username while figuring out the current process and cpu Ignores the username while figuring out the
times. To demonstrate this, do a "su" and do a "w" and a "w \-u". current process and cpu times. To demonstrate this, do a "su" and do a "w"
.TP 0.5i and a "w \-u".
.B "\-s " .TP
Use the short format. \fB\-s\fR, \fB\-\-short\fR
Don't print the login time, JCPU or PCPU times. Use the short format. Don't print the login time, JCPU or PCPU times.
.TP 0.5i .TP
.B "\-f " \fB\-f\fR, \fB\-\-from\fR
Toggle printing the Toggle printing the
.B from .B from
(remote hostname) field. The default as (remote hostname) field. The default as released is for the
released is for the
.B from .B from
field to not be printed, although your system administrator or field to not be printed, although your system administrator or distribution
distribution maintainer may have compiled a version in which the maintainer may have compiled a version in which the
.B from .B from
field is shown by default. field is shown by default.
.TP 0.5i .TP
.B "\-V " \fB\-\-help\fR
Display help text and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version information. Display version information.
.TP 0.5i .TP
.B "\-o " \fB\-o\fR, \fB\-\-old\-style\fR
Old style output. Prints blank space for idle times less than one minute. Old style output. Prints blank space for idle times less than one minute.
.TP 0.5i .TP
.B "user " .B "user "
Show information about the specified user only. Show information about the specified user only.
.SH ENVIRONMENT .SH ENVIRONMENT
.TP .TP
PROCPS_USERLEN PROCPS_USERLEN
Override the default width of the username column. Defaults to 8. Override the default width of the username column. Defaults to 8.
.TP .TP
PROCPS_FROMLEN PROCPS_FROMLEN
Override the default width of the from column. Defaults to 16. Override the default width of the from column. Defaults to 16.
.SH FILES .SH FILES
.TP .TP
.I /var/run/utmp .I /var/run/utmp
@ -76,8 +71,6 @@ information about who is currently logged on
.TP .TP
.I /proc .I /proc
process information process information
.PP
.SH "SEE ALSO" .SH "SEE ALSO"
.BR free (1), .BR free (1),
.BR ps (1), .BR ps (1),
@ -85,11 +78,17 @@ process information
.BR uptime (1), .BR uptime (1),
.BR utmp (5), .BR utmp (5),
.BR who (1) .BR who (1)
.SH AUTHORS .SH AUTHORS
.B w .B w
was re-written almost entirely by Charles Blake, based on the version by Larry was re-written almost entirely by Charles Blake, based on the version by
Greenfield <greenfie@gauss.rutgers.edu> and Michael K. Johnson .UR greenfie\@\:gauss.\:rutgers.\:edu
<johnsonm@redhat.com>. Larry Greenfield
.UE
Please send bug reports to <procps@freelists.org> and
.UR johnsonm\@\:redhat.\:com
Michael K. Johnson
.UE
.SH "REPORTING BUGS"
Please send bug reports to
.UR procps\@freelists.org
.UE