Changeset 771 in code for trunk/doc

Timestamp:

Feb 4, 2022, 3:47:34 PM (3 years ago)

Author:

contact

Message:

service: switch to -network flag for certfp and sasl commands

Instead of always requiring users to explicitly specify the network
name, guess it from the downstream connection.

Network commands are left as-is because it's not yet clear how to
handle them.

File:

• trunk/doc/soju.1.scd (modified) (3 diffs)

trunk/doc/soju.1.scd

@@ -326 +326 @@
                         Currently same as *message*. This is the default behaviour.
 
-*certfp generate* [options...] <network name>
+*certfp generate* [options...]
         Generate self-signed certificate and use it for authentication (via SASL
         EXTERNAL).
@@ -333 +333 @@
 
         Options are:
+
+        *-network* <name>
+                Select a network. By default, the current network is selected, if any.
 
         *-key-type* <type>
@@ -341 +344 @@
                 Size of RSA key to generate. Ignored for other key types.
 
-*certfp fingerprint* <network name>
+*certfp fingerprint* [options...]
         Show SHA-1 and SHA-256 fingerprints for the certificate
         currently used with the network.
 
-*sasl status* <network name>
+        Options are:
+
+        *-network* <name>
+                Select a network. By default, the current network is selected, if any.
+
+*sasl status* [options...]
         Show current SASL status.
 
-*sasl set-plain* <network name> <username> <password>
+        Options are:
+
+        *-network* <name>
+                Select a network. By default, the current network is selected, if any.
+
+*sasl set-plain* [options...] <username> <password>
         Set SASL PLAIN credentials.
 
-*sasl reset* <network name>
+        Options are:
+
+        *-network* <name>
+                Select a network. By default, the current network is selected, if any.
+
+*sasl reset* [options...]
         Disable SASL authentication and remove stored credentials.
+
+        Options are:
+
+        *-network* <name>
+                Select a network. By default, the current network is selected, if any.
 
 *user create* -username <username> -password <password> [options...]