commit 0198b57b7982bc5d06019344844f34d18ff7cb90
from: xs <xs@inda.re>
date: Tue Jun 10 08:58:11 2025 UTC

Updating r7.1

commit - 494d76b712786f365def48709b808f87abefc95e
commit + 0198b57b7982bc5d06019344844f34d18ff7cb90
blob - f9250d0554806c497ff41dbb3de6c78f1ed3944d
blob + 3e6d7688489b3ea53dcb1daaad648fe01cb119c3
--- r7.1
+++ r7.1
@@ -591,6 +591,20 @@ $ r7 output tools0 OpenBSD state_packages\[rs]*
 .PP
 \f[I]Note that the \f[CI]output\f[I] function arguments are using
 shell\[cq]s case globbing patterns.\f[R]
+.SS Active nodes
+A \f[CR]R7_WORKDIR/.active_nodes\f[R] file is automatically created when
+r7 tries to connect to a list of hosts via the \f[CR]group\f[R] command
+or function.
+This serves as a cache of available hosts reachable via SSH login (the
+username is specified in the SSH configuration file).
+.PP
+To add a previously non\-available host, simply remove the file and use
+\f[CR]group\f[R] (here via \f[CR]run\-config\f[R]):
+.IP
+.EX
+rm .active_nodes
+r7 run\-config
+.EE
 .SS r7 command line
 \f[B]\f[BI]Usage:\f[B]\f[R]
 .IP
@@ -1285,7 +1299,8 @@ nodes
 .EE
 .SS nodes\-active
 \f[B]\f[BI]Description:\f[B]\f[R] Returns a list of active nodes by
-detecting SSH availability
+detecting SSH availability (a login is done), writes
+\f[CR]R7_WORKDIR/.active_nodes\f[R] containing the available hosts
 .PP
 \f[B]\f[BI]Usage:\f[B]\f[R]
 .IP
@@ -1518,10 +1533,10 @@ Supported platforms are OpenBSD, FreeBSD, NetBSD and G
 .IP \[bu] 2
 Dependencies are awk, OpenSSH and column
 .IP \[bu] 2
-Busybox support is planned.
-.IP \[bu] 2
 Optional dependencies are openrsync, rsync, column, graphviz and pandoc.
 .IP \[bu] 2
+Busybox support is planned.
+.IP \[bu] 2
 The HTML output is a work in progress.
 .PP
    *   *   *   *   *