make-secnet-sites: Provide ArgActionLambda

[secnet.git] / README.make-secnet-sites

diff --git a/README.make-secnet-sites b/README.make-secnet-sites
index ea767e912f1616d05de31b8872280c1c18cf0d81..71a0e0f1e9c58a076b4c06bb0e7967762487467e 100644 (file)
--- a/README.make-secnet-sites
+++ b/README.make-secnet-sites
@@ -34,6 +34,23 @@ USAGE
        produce Secnet configuration.
 
 
+OPTIONS
+
+       --output-version NUMBER
+
+               Write backward-compatible sites file output,
+               targeting a particular sites format.  Values of
+               NUMBER that are understood are:
+                   1   The original format, pre signing key
+                       negotiation.
+               If NUMBER is higher than make-secnet-sites supports,
+               it writes out what it can.
+
+       --debug | -D
+
+               Increase amount of debugging output.
+
+
 INPUT SYNTAX
 
        The input files have a simple line-based syntax.  Blank lines,
@@ -186,6 +203,31 @@ INPUT SYNTAX
                Assigns BOOL to the `mobile' key.  Acceptable only at
                site level, but optional.
 
+       Properties which can also appear in public key files.
+       (named by `peer-keys' key to secnet sites closure.)
+       These are acceptable to make-secnet-sites only at
+       site level.  See also `Site long-term keys' in NOTES.
+
+       pub ALG DATAB91S
+               Defines a public key.  ALG is an algorithm name and
+               DATA91S is the public key data, encoded according to
+               secnet-base91 (see below).
+               Not yet suported in make-secnet-sites.
+
+       serial SETIDHEX
+               Specifies the key set id (8 hex digits representing
+               4 bytes: each pair is the value of the next byte).
+               May appear at most once.  If not present, 00000000.
+               Not yet suported in make-secnet-sites.
+
+       pkg GROUPIDHEX
+       pkgf GROUPIDHEX
+               Specifies the key group id for subsequent keys.
+               pkgf indicates a fallback group.
+               May be repeated (with different id values).
+               If not specified, 00000000.
+               Not yet suported in make-secnet-sites.
+
 
 OUTPUT STRUCTURE