updates.
[silc.git] / apps / irssi / docs / help / in / cmode.in
index 7d8f07636176b505b0a7bb4f5706b2c54997650e..37aae68cb47f828c905c51b5855c9424323ceb7b 100644 (file)
@@ -10,30 +10,51 @@ that mode.  Other modes both channel operator and founder may manage.
 
 The following modes are available:
 
-    p               Set/unset channel as private channel
+    p               Set/unset channel as private channel.  Private
+                    channels are shown with LIST command with an
+                    indication the channel is private.  Private
+                    channel is not shown on user's joined channel
+                    list (with for example WHOIS command).
+
     s               Set/unset channel as secret channel.  Secret
-                    channel are not shown in user's channel list
-                    or with /LIST command.
-    k               Enable/disable channel private key usage (*)
-    i               Set/unset channel as invite only channel
+                    channels are entirely invisible.  They are not
+                    shown with LIST command and they do not appear
+                    in user's joined channel list.
+
+    k               Enable/disable private channel key usage.   (*)
+                    When enabled KEY command may be used to set
+                    private channel key(s) on the channel.
+
+    i               Set/unset channel as invite only channel.  If
+                    you are the founder of the channel you will
+                    still be able to join the channel by giving
+                    command /JOIN channel -founder.
+
     t               Set/unset that only channel operator or
                     founder may set channel topic
+
     m               Set/unset user silencing.  Normal users
-                    are not able to talk on channel. (*)
+                    are not able to talk on channel.            (*)
+
     M               Set/unset operator silencing.  Operators
-                    are not able to talk on channel. (*)
-    l <limit>       Set/unset channel's user limit
+                    are not able to talk on channel.            (*)
+
+    l <limit>       Set/unset channel's user count limit
+
     a <passphrase>  Set/unset passphrase for channel that must
-                    be provided when joining to the channel. (*)
-    c <cipher>      Set/unset channel's cipher (*)
-    h <hmac>        Set/unset channel's hmac (*)
+                    be provided when joining to the channel.    (*)
+
+    c <cipher>      Set/unset channel's cipher                  (*)
+
+    h <hmac>        Set/unset channel's HMAC                    (*)
+
     f [<pubkeyfile> <privkeyfile> [<privkey passphrase>]]
-                    Set/unset channel founder authentication. (*)
+                    Set/unset channel founder authentication.   (*)
                     Channel founder may set this mode so that
-                    if the client leaves the channel it can
+                    when the client leaves the channel it can
                     claim the founder rights when it returns
                     to the channel, and to set the channel to
-                    be permanent channel.  You can claim the
+                    be permanent channel.  You can reclaim the
                     founder rights using CUMODE or JOIN commands.
 
                     If the <pubkeyfile> and <privkeyfile> is
@@ -43,7 +64,8 @@ The following modes are available:
                     server.  If these are omitted then the default
                     SILC keypair is used.  Normally you do not need
                     to provide these arguments.
-    C [{[+|-]<pubkeyfile> }]                                (*)
+
+    C [{[+|-]<pubkeyfile> }]                                    (*)
                     Set/unset channel public key mode, and add/remove
                     channel publics key from the channel public key
                     list.  When this mode is set only those users
@@ -71,10 +93,69 @@ Multiple modes can be set/unset at once if the modes does not
 require any arguments.  If mode requires an argument then only
 one mode can be set at once.
 
-When the +k (channel private key mode) mode is set the channel's
+When the +k (private channel key mode) mode is set the channel's
 default cipher and HMAC are not used.  The private key (see /HELP KEY
-for help how to set the private key) defines the cipher and HMAC for
-the channel while +k mode is set.  Also the +c and +h modes are ignored
-when channel private key is set.
+for help how to set the private channel key) defines the cipher and HMAC
+for the channel while +k mode is set.  Also the +c and +h modes are
+ignored when private channel key mode is set.
+
+Examples:
+
+  Set the channel a permanent (persistent).  The channel won't be
+  deleted when last user leaves the channel.  When you as the founder
+  leave the channel you will be able to reclaim the founder rights later.
+
+    /CMODE * +f
+
+  Reclaim founder rights (and operator privileges) for you channel:
+
+    /CUMODE * +of mynick
+
+  You can do the same during joining:
+
+    /JOIN yourchannel -founder
+
+  Change channel founder keypair on your channel.  You can do this if
+  you want to transfer founder rights to some other user or if you
+  created new keypair.  The operation requires that you have a copy of
+  the old keypair:
+
+    /CUMODE * +f mynick /path/to/old/pubkey /path/to/old/privkey
+    /CMODE * +f /path/to/new/pubkey /path/to/new/privkey
+
+  or simply /CMODE * +f if you are already using the new keypair.
+
+  Here's how to transfer founder rights to different user using
+  temporary keypair:
+
+    Create temporary keypair:
+
+      # silc -C
+
+    Become founder on your channel:
+
+      /CUMODE * +f mynick
+
+    Set the temporary keypair on the channel and then send the key
+    pair to your friend with for example encrypted Email:
+
+      /CMODE * +f /path/to/temp/pubkey /path/to/temp/privkey
+
+    Tell your friend to give the following command to become founder:
+
+      /CUMODE * +f yourfriend /path/to/temp/pubkey /path/to/temp/privkey
+
+    Your friend then sets his own keypair on the channel:
+
+      /CMODE * +f
+
+    After this the temporary keypair can be removed and your friend has
+    become the founder of the channel.  This way the founder rights can
+    be transferred without ever revealing your own keypair.  When your
+    friend becomes the founder your founder rights will be removed by
+    the server automatically.  It is also possible to continue using the
+    temporary keypair, thus sharing founder rights with two or more users.
+    Note that it is possible for only one user at a time to have founder
+    mode on the channel even if they share the keypair.
 
 See also: CUMODE, UMODE, JOIN, KEY