summaryrefslogtreecommitdiff
path: root/static/unix-v10/man1/ustats.1
blob: 5a18d5502814d2e9a9851dfb96311e80dec914b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
.TH USTATS 1 SHARE
.SH NAME
ustats \- show bar graphs of share scheduler user usage rates
.SH SYNOPSIS
.B ustats
[-Kn] [-cn] [-g] [-sn] [-r] [-L] [-o[N|P|S|O]]
.SH DESCRIPTION
.I Ustats
prints bar graphs of user usage rates.
.P
Invoked without arguments,
.I ustats
will print the graphs and exit.
The flags affect operation as follows:-
.RS 2
.TP "\w'flagXX'u"
.ul
flag
.ul
meaning
.TP
.BI -K n
Set the 
.I half-life
for decaying the displayed rate to
.B n
seconds [default 4].
.TP
.BI -c n
Continuous operation, where
.BR n ,
if present, limits the number of cycles.
.TP
.BI -g
Don't include scheduling groups.
.TP
.BI -s n
Delay time between updates becomes
.B n
seconds [default 4].
.TP
.BI -r
Don't include \fIroot\fP's usage.
.TP
.BI -L
The bar graphs are normalised between the minimum and maximum usages found.
Quite often, one particular user
(eg: \fIidle\fP)
will dominate the usage,
so this flag turns on the use of a logarithmic scale for normalisation.
.TP
.BI -o f
The normal ordering of users is in kernel \fIlnode\fP table order.
This allows a continuous display to show the least change as users
log in and log out.
There are alternate orders specifiable by the value of \fBf\fP:
.RS "\w'flagXXXX'u"
.PD 0
.TP 4
.B N
sort by user name
.TP
.B P
sort by user priority
.TP
.B S
sort by usage
.TP
.B O
default (\fIlnode\fP) ordering.
.PD
.RE
.SH EXAMPLES
.RS 4
\fBustats \-Lc | dis\fP
.SH SEE ALSO
dis(1),
rates(1),
shstats(1),
share(5).