updates.
[crypto.git] / doc / draft-riikonen-silc-pp-05.nroff
index b991f5a263e7f729e12ef81991c429b6cf9720d5..60a8469e5f0de3bb15ca76731335707f334edbaf 100644 (file)
@@ -1044,6 +1044,8 @@ represents the Disconnect Payload.
                      1                   2                   3
  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+|    Status     |                                               |
++-+-+-+-+-+-+-+-+                                               +
 |                                                               |
 ~                      Disconnect Message                       ~
 |                                                               |
@@ -1053,12 +1055,13 @@ represents the Disconnect Payload.
 .ce
 Figure 7:  Disconnect Payload
 
-
-
-
 .in 6
-o Disconnect Message (variable length) - Human readable
-  reason of the disconnection.
+o Status (1 byte) - Indicates the Status Type, defined in [SILC3]
+  for the reason of disconnection.
+
+o Disconnect Message (variable length) - Human readable UTF-8
+  encoded string indicating reason of the disconnection.  This
+  MAY be omitted.
 .in 3
 
 
@@ -1321,6 +1324,8 @@ UTF-8 [RFC2279] encoded.
       The <Old Client ID> is the old ID of the client which changed
       the nickname.  The <New Client ID> is the new ID generated by
       the change of the nickname.  The <nickname> is the new nickname.
+      Note that it is possible to send this notify even if the nickname
+      hasn't changed, but client ID has changed.
 
 
 7     SILC_NOTIFY_TYPE_CMODE_CHANGE
@@ -1473,11 +1478,64 @@ UTF-8 [RFC2279] encoded.
       <removing client> is defined in the [SILC4] with SILC_COMMAND_BAN
       command.
 
+
+16    SILC_NOTIFY_TYPE_ERROR
+
+      Sent when an error occurs during processing some SILC procedure.
+      This is not used when error occurs during command processing, see
+      [SILC3] for more information about commands and command replies.
+      This type is sent directly to the sender of the packet whose packet
+      caused the error.  See [SILC1] for definition when this type
+      can be sent.
+
+      Max Arguments:  256
+          Arguments:  (1) <Status Type>        (n) [...]
+
+      The <Status Type> is the error type defined in [SILC3].  Note that
+      same types are also used with command replies to indicate the
+      status of a command.  Both commands and this notify type share
+      same status types.  Rest of the arguments are status type
+      dependent and are specified with those status types that can be
+      sent currently inside this notify type in [SILC3].  The <Status
+      Type> is of size of 1 byte.
+
+
+17    SILC_NOTIFY_TYPE_WATCH
+
+      Sent to indicate change in a watched user.  Client can set
+      nicknames to be watched with SILC_COMMAND_WATCH command, and
+      receive notifications when they login to network, signoff from
+      the network or their user mode is changed.  This notify type
+      is used to deliver these notifications.  The notify type is
+      sent directly to the watching client.
+
+      Max Arguments:  4
+          Arguments:  (1) <Client ID>        (2) [<nickname>]
+                      (3) <user mode>        (4) [<Notify Type>]
+
+      The <Client ID> is the user's Client ID which is being watched,
+      and the <nickname> is its nickname.  If the client just
+      changed the nickname, then <nickname> is the new nickname, but
+      the <Client ID> is the old client ID.  The <user mode> is the
+      user's current user mode.  The <Notify Type> can be same as the
+      Notify Payload's Notify Type, and is 16 bit MSB first order value.
+      If provided it may indicate the notify that occurred for the
+      client.  If client logged in to the network the <Notify Type>
+      MUST NOT be present.
 .in 3
 
 Notify types starting from 16384 are reserved for private notify
 message types.
 
+Router server which receives SILC_NOTIFY_TYPE_SIGNOFF, 
+SILC_NOTIFY_TYPE_SERVER_SIGNOFF, SILC_NOTIFY_TYPE_KILLED,
+SILC_NOTIFY_TYPE_NICK_CHANGE and SILC_NOTIFY_TYPE_UMODE_CHANGE
+MUST chech whether someone in the local cell is watching the nickname
+the client has, and send the SILC_NOTIFY_TYPE_WATCH notify to the
+watcher, unless the client in case has the SILC_UMODE_REJECT_WATCHING
+user mode set.  If the watcher client and the client that was
+watched is same the notify SHOULD NOT be sent.
+
 
 .ti 0
 2.3.8 Error Payload
@@ -1650,7 +1708,7 @@ o Message Flags (2 bytes) - Includes the Message Flags of
           Private range for free use.
 
 o Message Length (2 bytes) - Indicates the length of the
-  the Message Data field in the payload, not including any 
+  Message Data field in the payload, not including any 
   other field.
 
 o Message Data (variable length) - The actual message to
@@ -1683,7 +1741,7 @@ o Initial Vector (variable length) - The initial vector
   initial vector.  This field is not encrypted.  This field
   is not included into the padding calculation.  Length
   of this field equals the cipher's block size.  This field
-  is, however, authenticated.
+  is, however authenticated.
 .in 3