summaryrefslogtreecommitdiff
path: root/static/v10/man1/shstats.1
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 21:07:28 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 21:07:28 -0400
commit711594636704defae873be1a355a292505585afd (patch)
tree59ee13f863830d8beba6cfd02bbe813dd486c26f /static/v10/man1/shstats.1
parent3258a063c1f189d7b019e40e525b46bef9b9a7b1 (diff)
docs: Added UNIX V10 Manuals
Diffstat (limited to 'static/v10/man1/shstats.1')
-rw-r--r--static/v10/man1/shstats.172
1 files changed, 72 insertions, 0 deletions
diff --git a/static/v10/man1/shstats.1 b/static/v10/man1/shstats.1
new file mode 100644
index 00000000..ce91584c
--- /dev/null
+++ b/static/v10/man1/shstats.1
@@ -0,0 +1,72 @@
+.TH SHSTATS 1 SHARE
+.SH NAME
+shstats \- show histogram of share scheduler user priorities
+.SH SYNOPSIS
+.B shstats
+[-#] [-cn] [-sn] [-un]
+.SH DESCRIPTION
+.I Shstats
+prints a table of system scheduling parameters,
+the share variables for a selected user (default: the invoker),
+and a histogram of users vs. normalised usage.
+In the histogram, the current user selected
+is represented by the character `\fB~\fP',
+and other users by a unique character
+in the \fIascii\fP range `\fB!\fP' to `\fB}\fP'.
+.P
+Invoked without arguments,
+.I shstats
+will print the table and exit.
+The flags affect operation as follows:-
+.RS 2
+.TP 10
+.ul
+flag
+.ul
+meaning
+.TP
+.BI -#
+All users except the invoker will be represented by the character \fB#\fP.
+.TP
+.BI -c n
+Continuous operation, where
+.BR n ,
+if present, limits the number of cycles.
+.TP
+.BI -s n
+Delay time between updates becomes
+.B n
+seconds [default 4].
+.TP
+.BI -u n
+Change the selected user to the one whose
+.I uid
+matches
+.IR n .
+.P
+In continuous non-\fIhash\fP mode,
+.I shstats
+will read the
+.I "standard input"
+while waiting for the next display update
+for the invoker to type the identifier for a user to select.
+This can be either a single character
+to select the user represented by that character in the histogram,
+or a login name, or a uid.
+.SH EXAMPLES
+.RS 4
+\fBshstats \-#c | dis\fP
+.SH SEE ALSO
+dis(1),
+rates(1),
+ustats(1),
+share(5).
+.SH BUGS
+Reading from the
+.I "standard input"
+when output is piped through
+.I dis
+doesn't seem to work,
+perhaps because of some weirdness in the way
+.I curses
+drives the screen.