aboutsummaryrefslogtreecommitdiff
path: root/usr.bin/w
diff options
context:
space:
mode:
authorFernando ApesteguĂ­a <fernape@FreeBSD.org>2020-08-24 17:57:08 +0000
committerFernando ApesteguĂ­a <fernape@FreeBSD.org>2020-08-24 17:57:08 +0000
commit3f8c71d1c90fdc3308a772713fcac08c3f1245c5 (patch)
tree1415db150d447df97f5840e62e70d7cbae1beb80 /usr.bin/w
parent75b4d546cd9d9f62a5a3466e6df5629262aef7b1 (diff)
downloadsrc-3f8c71d1c90fdc3308a772713fcac08c3f1245c5.tar.gz
src-3f8c71d1c90fdc3308a772713fcac08c3f1245c5.zip
w(1): Add EXAMPLES to man page
Add small example section showing general use and -d and -h flags Approved by: manpages (bcr@) Differential Revision: https://reviews.freebsd.org/D26172
Notes
Notes: svn path=/head/; revision=364719
Diffstat (limited to 'usr.bin/w')
-rw-r--r--usr.bin/w/w.141
1 files changed, 37 insertions, 4 deletions
diff --git a/usr.bin/w/w.1 b/usr.bin/w/w.1
index 074d107cda5f..7fe22bc70541 100644
--- a/usr.bin/w/w.1
+++ b/usr.bin/w/w.1
@@ -28,7 +28,7 @@
.\" @(#)w.1 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$
.\"
-.Dd December 1, 2015
+.Dd August 24, 2020
.Dt W 1
.Os
.Sh NAME
@@ -99,6 +99,41 @@ names are specified, the output is restricted to those users.
.It Pa /var/run/utx.active
list of users on the system
.El
+.Sh EXAMPLES
+Show global activity of the system:
+.Bd -literal -offset indent
+$ w
+ 8:05PM up 35 mins, 3 users, load averages: 0.09, 0.35, 0.27
+USER TTY FROM LOGIN@ IDLE WHAT
+fernape v0 - 7:30PM - tmux: client (/tmp/tmux-1001/default) (tmux)
+root v1 - 8:03PM 1 -bash (bash)
+fernape pts/0 tmux(1391).%0 8:04PM - w
+.Ed
+.Pp
+Show the entire process list per tty:
+.Bd -literal -offset indent
+$ w -d
+ 8:12PM up 42 mins, 3 users, load averages: 0.01, 0.11, 0.17
+USER TTY FROM LOGIN@ IDLE WHAT
+ 1199 login [pam] (login)
+ 1207 -bash (bash)
+ 1507 tmux: client (/tmp/tmux-1001/default) (tmux)
+fernape v0 - 7:30PM - tmux: client (/tmp/tmux-1001/default) (tmux)
+ 1488 login [pam] (login)
+ 1489 -bash (bash)
+root v1 - 8:08PM 3 -bash (bash)
+ 1510 -bash (bash)
+ 1515 w -d
+fernape pts/0 tmux(1509).%0 8:11PM - w -d
+.Ed
+.Pp
+Same as above but only for the root user and omitting the heading:
+.Bd -literal -offset indent
+$ w -d -h root
+ 1183 login [pam] (login)
+ 1204 -bash (bash)
+root v1 - 7:15PM - -bash (bash)
+.Ed
.Sh COMPATIBILITY
The
.Fl f ,
@@ -137,9 +172,7 @@ to ignore interrupts.
prints
.Ql \- . )
.Pp
-The
-.Tn CPU
-time is only an estimate, in particular, if someone leaves a background
+The CPU time is only an estimate, in particular, if someone leaves a background
process running after logging out, the person currently on that terminal is
.Dq charged
with the time.