From 97d5c458cfa039d857301e1ca7d5af3beb37131d Mon Sep 17 00:00:00 2001
From: Jacob McDonnell <jacob@jacobmcdonnell.com>
Date: Sun, 26 Apr 2026 16:38:00 -0400
Subject: build: Better Build System

---
 static/unix-v10/man1/ustats.1 | 80 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 static/unix-v10/man1/ustats.1

(limited to 'static/unix-v10/man1/ustats.1')

diff --git a/static/unix-v10/man1/ustats.1 b/static/unix-v10/man1/ustats.1
new file mode 100644
index 00000000..5a18d550
--- /dev/null
+++ b/static/unix-v10/man1/ustats.1
@@ -0,0 +1,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).
-- 
cgit v1.2.3