Update example.conf with Windows commands for mkpasswd/gencloak/spkifp

These work since UnrealIRCd 6.0.2.

diff --git a/doc/conf/examples/example.conf b/doc/conf/examples/example.conf
index 28bbbff2b81280de39251a203a082cb95233bb41..d977dad8850958a50dc7dfd351833956903cb14f 100644 (file)
--- a/doc/conf/examples/example.conf
+++ b/doc/conf/examples/example.conf
@@ -157,10 +157,11 @@ oper bobsmith {
        class opers;
        mask *@*;
 
-       /* Technically you can put oper passwords in plaintext in the conf
-        * but this is HIGHLY DISCOURAGED. Instead, on *NIX in the shell run:
-        * ./unrealircd mkpasswd
-        * ...to generate a password hash and paste the result here:
+       /* Technically you can put oper passwords in plaintext in the conf but
+        * this is HIGHLY DISCOURAGED. Instead you should generate a password hash:
+        * On *NIX, run: ./unrealircd mkpasswd
+        * On Windows, run: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" mkpasswd
+        * .. and then paste the result below:
         */
        password "$argon2id..etc..";
        /* See https://www.unrealircd.org/docs/Authentication_types for
@@ -239,7 +240,9 @@ link hub.example.org
        }
 
        /* We use the SPKI fingerprint of the other server for authentication.
-        * Run './unrealircd spkifp' on the other side to get it.
+        * Open a shell on the OTHER SERVER and run the command to get the fingerprint:
+        * On *NIX, run: ./unrealircd spkifp
+        * On Windows, run: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" spkifp
         */
        password "AABBCCDDEEFFGGHHIIJJKKLLMMNNOOPPQQRRSSTTUUV=" { spkifp; }
 
@@ -462,8 +465,9 @@ set {
         * They are used for generating masked hosts and should be kept secret.
         * The keys should be 3 random strings of 80 characters each (or more).
         * and must consist of lowcase (a-z), upcase (A-Z) and digits (0-9).
-        * HINT: On *NIX, you can run './unrealircd gencloak' in your shell to let
-        *       UnrealIRCd generate 3 random strings for you.
+        * On *NIX, you can run './unrealircd gencloak' in your shell to let
+        * UnrealIRCd generate 3 random strings for you.
+        * On Windows, you can run "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" gencloak
         */
        cloak-keys {
                "Oozahho1raezoh0iMee4ohvegaifahv5xaepeitaich9tahdiquaid0geecipahdauVaij3zieph4ahi";

diff --git a/doc/conf/examples/example.es.conf b/doc/conf/examples/example.es.conf
index 78696836f8fefbfd569cb61f3262aeef9171445b..988524b946fd19a440e00beee5700c74c18051e2 100644 (file)
--- a/doc/conf/examples/example.es.conf
+++ b/doc/conf/examples/example.es.conf
@@ -146,10 +146,11 @@ oper bobsmith {
        class opers;
        mask *@*;
 
-       /* Technically you can put oper passwords in plaintext in the conf
-        * but this is HIGHLY DISCOURAGED. Instead, on *NIX in the shell run:
-        * ./unrealircd mkpasswd
-        * ...to generate a password hash and paste the result here:
+       /* Technically you can put oper passwords in plaintext in the conf but
+        * this is HIGHLY DISCOURAGED. Instead you should generate a password hash:
+        * On *NIX, run: ./unrealircd mkpasswd
+        * On Windows, run: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" mkpasswd
+        * .. and then paste the result below:
         */
        password "$argon2id..etc..";
        /* See https://www.unrealircd.org/docs/Authentication_types for
@@ -229,6 +230,7 @@ link hub.ejemplo.org
 
        /* Usamos la huella digital SPKI del otro servidor para la autenticación.
         * Ejecute './unrealircd spkifp' en el otro lado del linkeo para obtenerlo.
+        * ( Windows: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" spkifp )
         */
        password "AABBCCDDEEFFGGHHIIJJKKLLMMNNOOPPQQRRSSTTUUV=" { spkifp; }
 
@@ -450,6 +452,7 @@ set {
    * y debe constar de minúsculas (a-z), mayúsculas (A-Z) y dígitos (0-9).
    * SUGERENCIA: En *NIX, puede ejecutar './unrealircd gencloak' en su shell para dejar
    * UnrealIRCd genera 3 cadenas aleatorias para ti.
+   * On Windows, you can run "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" gencloak
    */  
        cloak-keys {
                "Oozahho1raezoh0iMee4ohvegaifahv5xaepeitaich9tahdiquaid0geecipahdauVaij3zieph4ahi";

diff --git a/doc/conf/examples/example.fr.conf b/doc/conf/examples/example.fr.conf
index b7d672bb4088da700e3460c7cf02c7213226d3d6..8ceffefb6968fd091973ab80212c6947a74e8fc1 100644 (file)
--- a/doc/conf/examples/example.fr.conf
+++ b/doc/conf/examples/example.fr.conf
@@ -159,10 +159,11 @@ oper bobsmith {
        class opers;
        mask *@*;
 
-       /* Technically you can put oper passwords in plaintext in the conf
-        * but this is HIGHLY DISCOURAGED. Instead, on *NIX in the shell run:
-        * ./unrealircd mkpasswd
-        * ...to generate a password hash and paste the result here:
+       /* Technically you can put oper passwords in plaintext in the conf but
+        * this is HIGHLY DISCOURAGED. Instead you should generate a password hash:
+        * On *NIX, run: ./unrealircd mkpasswd
+        * On Windows, run: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" mkpasswd
+        * .. and then paste the result below:
         */
        password "$argon2id..etc..";
        /* See https://www.unrealircd.org/docs/Authentication_types for
@@ -460,6 +461,7 @@ set {
         * (voir l'exemple)
         * NB : sur *NIX, vous pouvez exécuter './unrealircd gencloak' sur votre
         *      serveur pour que Unrealircd génère 3 clés aléatoires pour vous.
+        *      On Windows, use "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" gencloak
         */
        cloak-keys {
                "Oozahho1raezoh0iMee4ohvegaifahv5xaepeitaich9tahdiquaid0geecipahdauVaij3zieph4ahi";

diff --git a/doc/conf/examples/example.tr.conf b/doc/conf/examples/example.tr.conf
index a915e29e394325f7656e566572235644979d86d6..955a618d22fe59b233d360c1dc149e716f264c3f 100644 (file)
--- a/doc/conf/examples/example.tr.conf
+++ b/doc/conf/examples/example.tr.conf
@@ -158,10 +158,11 @@ oper bobsmith {
        class opers;
        mask *@*;
 
-       /* Technically you can put oper passwords in plaintext in the conf
-        * but this is HIGHLY DISCOURAGED. Instead, on *NIX in the shell run:
-        * ./unrealircd mkpasswd
-        * ...to generate a password hash and paste the result here:
+       /* Technically you can put oper passwords in plaintext in the conf but
+        * this is HIGHLY DISCOURAGED. Instead you should generate a password hash:
+        * On *NIX, run: ./unrealircd mkpasswd
+        * On Windows, run: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" mkpasswd
+        * .. and then paste the result below:
         */
        password "$argon2id..etc..";
        /* See https://www.unrealircd.org/docs/Authentication_types for
@@ -241,6 +242,7 @@ link hub.example.org
 
        /* Kimlik doğrulaması için diğer sunucunun SPKI parmak izini kullanıyoruz.
         * Kullanmamız için diğer tarafda './unrealircd spkifp' uygulayıp çalıştırıyoruz.
+        * ( Windows: "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" spkifp )
         */
        password "AABBCCDDEEFFGGHHIIJJKKLLMMNNOOPPQQRRSSTTUUV=" { spkifp; }
 
@@ -462,6 +464,7 @@ set {
         * büyük harf (A-Z) ve rakamlardan (0-9) meydana gelmelidirler.. [ilk örneğe bakınız].
         * IPUCU: './unrealircd gencloak' Unrealircd sizin için rastgele 3 adet dizin oluşturur.
         *        Bunu NIX üzerinde çalıştırabilirsiniz.
+        *        On Windows, use "C:\Program Files\UnrealIRCd 6\bin\unrealircdctl" gencloak
         */
        cloak-keys {
                "Oozahho1raezoh0iMee4ohvegaifahv5xaepeitaich9tahdiquaid0geecipahdauVaij3zieph4ahi";