.ds RF FORMFEED[Page %]
.ds CF
.ds LH Internet Draft
-.ds RH XXX
+.ds RH 25 November 2002
.ds CH
.na
.hy 0
.nf
Network Working Group P. Riikonen
Internet-Draft
-draft-riikonen-silc-commands-04.txt XXX
-Expires: XXX
+draft-riikonen-silc-commands-04.txt 25 November 2002
+Expires: 25 April 2003
.in 3
1 Introduction .................................................. 2
1.1 Requirements Terminology .................................. 2
2 SILC Commands ................................................. 2
- 2.1 SILC Commands Syntax ...................................... 2
- 2.2 SILC Command Argument Idioms .............................. 2
+ 2.1 SILC Commands Syntax ...................................... 4
+ 2.2 SILC Command Argument Idioms .............................. 4
2.3 SILC Commands List ........................................ 4
- 2.4 SILC Command Status Payload ............................... 40
-3 SILC Status Types ............................................. 41
-4 Security Considerations ....................................... 47
-5 References .................................................... 47
-6 Author's Address .............................................. 49
-Appendix A ...................................................... 49
+ 2.4 SILC Command Status Payload ............................... 42
+3 SILC Status Types ............................................. 43
+4 Security Considerations ....................................... 49
+5 References .................................................... 49
+6 Author's Address .............................................. 51
+Appendix A ...................................................... 51
.ti 0
may return inside the <Status Payload>. All status messages
are defined in the section 2.3 SILC Command Status Payload
The status messages defined with the command are recommendations.
-It is possible to return other status messages not listes with
+It is possible to return other status messages not listed with
the command reply definition.
.in 3
The command replies include the Client ID of the nickname,
nickname and server name, user name and host name and user's real
- name. Client SHOULD process these replies only after the last
+ name. Client should process these replies only after the last
reply has been received with the STATUS_LIST_END status. If the
<count> option were defined in the query there will be only
<count> many replies from the server.
Identify command is used to query information about an entity by
the entity's name or ID. This command can be used to query
- information about clients, server and channels.
+ information about clients, servers and channels.
The query may find multiple matching entities. The <count> option
may be given to narrow down the number of accepted results. If
Implementations may not want to give interface access to this
command as it is hardly a command that would be used by an end
- user. However, it must be implemented as it is used with private
- message sending.
+ user. However, it must be implemented as it is most likely used
+ with private message sending.
The IDENTIFY command MUST be always sent to the router by server
so that all users are searched. However, server MUST still search
When nickname is changed new Client ID is generated. Server MUST
distribute SILC_NOTIFY_TYPE_NICK_CHANGE to local clients on the
channels (if any) the client is joined on. Then it MUST send
- SILC_PACKET_REPLACE_ID to its primary route to replace the old
- Client ID with the new one.
+ SILC_NOTIFY_TYPE_NICK_CHANGE notify to its primary route to
+ notify about nickname and Client ID change.
Reply messages to the command:
Arguments: (1) <Status Payload> (2) <New ID Payload>
(3) <nickname>
- This command is replied always with New ID Payload that is
+ This command replies always with <New ID Payload> that is
generated by the server every time user changes their nickname.
Client receiving this payload MUST start using the received
Client ID as its current valid Client ID. The New ID Payload
channel key that even servers do not know. Naturally,
this requires that every client on the channel knows
the key before hand (it is considered to be pre-shared-
- key). The key material is RECOMMENDED to be processed
- as stated in the [SILC3] in the section Processing the
- Key Material.
+ key). The key material SHOULD be processed as stated
+ in the [SILC3] in the section Processing the Key Material.
As it is local setting it is possible to have several
private channel keys on one channel. In this case several
If this mode is already set but the <founder pubkey> is
different the new key will replace the old founder key and
- the new key is distribute in the network with the
+ the new key is distributed in the network with the
SILC_NOTIFY_TYPE_CMODE_CHANGE notify. Only the original
founder may set this mode multiple times and the client
MUST have SILC_CUMODE_FOUNDER mode on the channel.
mode is set the channel MUST NOT be destroyed. The founder
can reclaim the founder mode back on these empty channels
at any time. Implementations MAY limit the number of how
- many channels a user can own.
+ many channels a user can own and how long they remain
+ persistent.
Typical implementation would use [+|-]f on user interface
to set/unset this mode.
been set, the client can claim channel founder privileges
by providing the <auth payload> that the server will use
to authenticate the client. The public key that server will
- use to verify the <auth payload> MUST the same public key
+ use to verify the <auth payload> MUST be the same public key
that was saved when the SILC_CMODE_FOUNDER_AUTH channel
mode was set. The client MAY remove this mode at any time.
and with list of user modes on the channel.
If the requested channel is a private or secret channel, this
- command MUST NOT send the list of users, but error is returned
- to the sender, except if the sender is on the channel, or the
- sender is server.
+ command MUST NOT send the list of users, except if the sender is
+ on the channel, or the sender is a server. Otherwise, error is
+ returned to the sender.
Reply messages to the command:
EMail: priikone@iki.fi
-This Internet-Draft expires XXX
+This Internet-Draft expires 25 April 2003
.ti 0