commit 494d76b712786f365def48709b808f87abefc95e
from: xs <xs@inda.re>
date: Tue Jun 10 08:57:22 2025 UTC

Documentation update, adding informations on .active_nodes

commit - c798ff754af0214aabcc13c28cd11e48ddcf0062
commit + 494d76b712786f365def48709b808f87abefc95e
blob - 6ffcd67c8464337fe49c1f601a81a72daa314701
blob + 39b3cd51e6bd3df38183f45f8f1afda3ed2bbdcd
--- README.md
+++ README.md
@@ -581,6 +581,21 @@ $ r7 output tools0 OpenBSD state_packages\*
 
 _Note that the `output` function arguments are using shell's case globbing patterns._
 
+### Active nodes
+
+A `R7_WORKDIR/.active_nodes` file is automatically created when r7 tries to
+connect to a list of hosts via the `group` command or function. This serves as a
+cache of available hosts reachable via SSH login (the username is specified in
+the SSH configuration file).
+
+To add a previously non-available host, simply remove the file and use `group`
+(here via `run-config`):
+
+```sh
+rm .active_nodes
+r7 run-config
+```
+
 ## r7 command line
 
 ***Usage:***
@@ -1113,7 +1128,8 @@ nodes
 ### nodes-active
 
 ***Description:***
-Returns a list of active nodes by detecting SSH availability
+Returns a list of active nodes by detecting SSH availability (a login is done), writes
+`R7_WORKDIR/.active_nodes` containing the available hosts
 
 ***Usage:***
 ```sh
@@ -1363,8 +1379,8 @@ import HOST
 - Supported shells are ksh93, oksh, yash and bash.
 - Supported platforms are OpenBSD, FreeBSD, NetBSD and GNU/Linux.
 - Dependencies are awk, OpenSSH and column
-- Busybox support is planned.
 - Optional dependencies are openrsync, rsync, column, graphviz and pandoc.
+- Busybox support is planned.
 - The HTML output is a work in progress.
 
 ---
blob - 5dd9a4bd716ded58cd68d3742e322e876bd34a71
blob + ff703b5462b48a29ce68e1a316f888a0f2ece681
--- r7
+++ r7
@@ -21,7 +21,6 @@
 # ====================
 
 VERSION=0.1.6
-: "${HOSTNAME:=$(uname -n)}"
 
 # shellcheck disable=SC2031
 _init_env() {
blob - e00ecdfe81e3b4b9620de9272185178d7fce6f03
blob + f9250d0554806c497ff41dbb3de6c78f1ed3944d
--- r7.1
+++ r7.1
@@ -1516,6 +1516,8 @@ Supported shells are ksh93, oksh, yash and bash.
 .IP \[bu] 2
 Supported platforms are OpenBSD, FreeBSD, NetBSD and GNU/Linux.
 .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.