From feae322e9a6bca113342f6b944463af22f7f898e Mon Sep 17 00:00:00 2001
From: Minijackson <minijackson@riseup.net>
Date: Fri, 24 Jan 2025 11:28:32 +0100
Subject: [PATCH] docs: add casw cli reference imported from CAref.html

---
 documentation/ca-cli.md        |  1 +
 modules/ca/src/client/Makefile |  1 +
 modules/ca/src/client/casw.md  | 26 ++++++++++++++++++++++++++
 3 files changed, 28 insertions(+)
 create mode 100644 modules/ca/src/client/casw.md

diff --git a/documentation/ca-cli.md b/documentation/ca-cli.md
index 760139df8..42c0ecfdc 100644
--- a/documentation/ca-cli.md
+++ b/documentation/ca-cli.md
@@ -16,4 +16,5 @@ caput
 
 acctst
 catime
+casw
 ```
diff --git a/modules/ca/src/client/Makefile b/modules/ca/src/client/Makefile
index 56e2364b7..8e2379cfc 100644
--- a/modules/ca/src/client/Makefile
+++ b/modules/ca/src/client/Makefile
@@ -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
diff --git a/modules/ca/src/client/casw.md b/modules/ca/src/client/casw.md
new file mode 100644
index 000000000..dab63c1c8
--- /dev/null
+++ b/modules/ca/src/client/casw.md
@@ -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.
+