docs: add casw cli reference imported from CAref.html

This commit is contained in:
Minijackson
2025-01-24 11:28:32 +01:00
committed by Andrew Johnson
parent 1b1bb34c83
commit feae322e9a
3 changed files with 28 additions and 0 deletions

View File

@@ -14,6 +14,7 @@ include $(TOP)/configure/CONFIG
HTMLS += CAref.html
DOCS += acctst.md
DOCS += catime.md
DOCS += casw.md
#
# includes to install from this subproject

View File

@@ -0,0 +1,26 @@
# casw
casw [-i <interest level>]
## Description
CA server "beacon anomaly" logging.
CA server beacon anomalies occur when a new server joins the network, a
server is rebooted, network connectivity to a server is reestablished,
or if a server's CPU exits a CPU load saturated state.
CA clients with unresolved channels reset their search request
scheduling timers whenever they see a beacon anomaly.
This program can be used to detect situations where there are too many
beacon anomalies. IP routing configuration problems may result in false
beacon anomalies that might cause CA clients to use unnecessary
additional network bandwidth and server CPU load when searching for
unresolved channels.
If there are no new CA servers appearing on the network, and network
connectivity remains constant, then casw should print no messages at
all. At higher interest levels the program prints a message for every
beacon that is received, and anomalous entries are flagged with a star.