|
|
1.1 root 1: .TH SHSTATS 1 SHARE
2: .SH NAME
3: shstats \- show histogram of share scheduler user priorities
4: .SH SYNOPSIS
5: .B shstats
6: [-#] [-cn] [-sn] [-un]
7: .SH DESCRIPTION
8: .I Shstats
9: prints a table of system scheduling parameters,
10: the share variables for a selected user (default: the invoker),
11: and a histogram of users vs. normalised usage.
12: In the histogram, the current user selected
13: is represented by the character `\fB~\fP',
14: and other users by a unique character
15: in the \fIascii\fP range `\fB!\fP' to `\fB}\fP'.
16: .P
17: Invoked without arguments,
18: .I shstats
19: will print the table and exit.
20: The flags affect operation as follows:-
21: .RS 2
22: .TP 10
23: .ul
24: flag
25: .ul
26: meaning
27: .TP
28: .BI -#
29: All users except the invoker will be represented by the character \fB#\fP.
30: .TP
31: .BI -c n
32: Continuous operation, where
33: .BR n ,
34: if present, limits the number of cycles.
35: .TP
36: .BI -s n
37: Delay time between updates becomes
38: .B n
39: seconds [default 4].
40: .TP
41: .BI -u n
42: Change the selected user to the one whose
43: .I uid
44: matches
45: .IR n .
46: .P
47: In continuous non-\fIhash\fP mode,
48: .I shstats
49: will read the
50: .I "standard input"
51: while waiting for the next display update
52: for the invoker to type the identifier for a user to select.
53: This can be either a single character
54: to select the user represented by that character in the histogram,
55: or a login name, or a uid.
56: .SH EXAMPLES
57: .RS 4
58: \fBshstats \-#c | dis\fP
59: .SH SEE ALSO
60: dis(1),
61: rates(1),
62: ustats(1),
63: share(5).
64: .SH BUGS
65: Reading from the
66: .I "standard input"
67: when output is piped through
68: .I dis
69: doesn't seem to work,
70: perhaps because of some weirdness in the way
71: .I curses
72: drives the screen.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.