b8f2c9ec9c6ab91c835fc6416953966e10df9119
[silc.git] / TODO
1 TODO/bugs in Irssi SILC client
2 ==============================
3
4  o Add local command to switch the channel's private key when channel has
5    several private keys.  Currently sending channel messages with many
6    keys is not possible because changing the key is not possible by the
7    user.
8
9  o JOINing to +a (requires passphrase to JOIN) does not work on autojoin.
10    Seems the passwords in the .silc/config has no effect.
11
12  o Add local commands to list the current server and client public keys
13    that the user has.  And a local command to dump the contents of the
14    public key to the screen.  Something like LISTKEYS, SHOWKEY...
15
16  o We should get rid of the clientconfig.[ch] in Irssi SILC and move the
17    cipher, hash, hmac and pkcs configuration to the Irssi SILC's config
18    file.
19
20  o Add PERL scripting support from Irssi CVS.
21
22  o Extend the /HELP command to support sub commands or something.  So
23    that user can say /help set mutual_authentication they would get
24    help of the mutual_authentication setting.
25
26  o Set different kind of settings, like, /set mutual_authentication,
27    /set key_exchange_timeout, /set conn_auth_timeout etc etc.
28
29
30 TODO/bugs In SILC Client Library
31 ================================
32
33  o The PRIVATE_MESSAGE_KEY packet is not handled (it is implemented 
34    though).  This should be added and perhaps new client operation
35    should be added to notify application that it was received and
36    set the key only if application wishes to set (accept the key) it.
37
38  o Additions to do after protocol version 1.1:
39
40         o Fix the NICK_CHANGE notify handling not to create new entry
41           for the changed client, but take the nickname from the notify
42           (removes need for resolving as well).  Protocol TODO entry 3.
43
44         o Add support for list of errors in command replies.  Protocol
45           TODO entry 1.
46
47
48 TODO/bugs In SILC Server
49 ========================
50
51  o The router should check for validity of received notify packets from
52    servers (after all buggy servers may send notify that is actually
53    something that should have not been sent).
54
55  o Add hashed passwords to silcd.conf file.
56
57  o Backup router related issues
58
59         o Channel user mode changes are notified unnecessarely when
60           switching to backup router on router crash.
61
62  o Add a timeout to handling incoming JOIN commands.  It should be 
63    enforced that JOIN command is executed only once in a second or two
64    seconds.  Now it is possible to accept n incoming JOIN commands
65    and process them without any timeouts.  THis must be employed because
66    each JOIN command will create and distribute the new channel key
67    to everybody on the channel.
68
69  o New configuration file format must be added.  The new one will be
70    done using the dotconf config library (lib/dotconf).  The following
71    tasks relates closely to this as well and must be done at the same time
72    when adding the new config file format:
73
74         o Server says that it is able to listen on multiple ports but
75           currently that is bogus.  It can, but internals are for single
76           server.
77
78         o Protocol execution timeouts are hard coded, should be
79           configurable.
80
81         o IP address fields in configuration file should accept mask
82           format as well, IP/MASK, and not just plain IP.
83
84  o If client's public key is saved in the server (and doing public key
85    authentication) then the hostname and the username information could
86    be taken from the public key.  Should be a configuration option!
87
88
89 TODO/bugs In SILC Libraries
90 ===========================
91
92  o WIN32 silc_net_create_connection_async does not work the same way
93    than on Unix.  Do it with threads on WIN32.  The function works but
94    is not actually async currently.
95
96  o Rewrite the lib/silcsim/silcsim.h.  The SilcSimContext should be
97    private and silc_sim_alloc should take necessary arguments.
98
99
100 TODO in SILC Protocol
101 =====================
102
103 Current protocol version is 1.0.  However, it is far from being perfect,
104 and needs to include additional features.  Following protocol TODO entries
105 describe new stuff to be added to protocol versions 1.x.
106
107  1. Re-define the Status Payload: it is now 16 bits, split it into two
108     8 bits fields.  First field includes status types from 0 - 9 and
109     10 - n *if* it is not an list of errors.  If it is list of errors then
110     the first field includes 1, 2 and/or 3, and the second field includes
111     the error status 10 - n.  This way it is possible to send multiple
112     errors (list of errors) and we have a way to tell the receiver that
113     there will be other errors as well.  The second field is used only
114     if there is list of errors.  If normal status, or normal (single)
115     error status the second field is set to zero, and must be ignored.
116     Hence, the status works same way as now except for list of errors.
117     To be included in protocol version 1.1.
118
119  2. Define that WHOIS and IDENTIFY commands must send list of errors
120     if multiple Client ID (or Channel ID and Server ID for IDENTIFY) was
121     requested and was not found.  Each unfound entry must cause an error
122     command reply to the sender.  Also define that errors must be sent
123     *after* sending successfully found entries (this way receiver may
124     ignore them).  To be included in protocol version 1.1.
125
126  3. Define the NICK_CHANGE notify to send the changed nickname as a new
127     third argument.  This will make the NICK_CHANGE notify handling easier
128     in the receiver's end (client primarily) since it removes the
129     requirement that receiver must resolve (using IDENTIFY or WHOIS) the
130     new Client ID received in the notify (because of the new nickname is
131     unknown).  To be included in protocol version 1.1.
132
133  4. Add "request parameters" or similar to the WHOIS command, which can
134     be used to request various parameters (something not returned by
135     standard WHOIS command) about clients (info that could be fetched
136     even from clients).  Additional specification (or appendix) should 
137     be done to define the payload and the parameters.  It could be used
138     to make the WHOIS command support various search conditions as well.
139     This would be the way to extend the WHOIS command to support various
140     new features without always making the command incompatible to previous
141     version.  To be included in protocol version 1.1.
142
143  5. Inviting and banning by public key should be made possible.  To be
144     included in protocol version 1.x.
145
146  6. Add perhaps SILENCE_USERS, SILENCE_OPERS channel user modes which
147     can be used to silence (moderate) normal users and opers (this set
148     only by founder).  To be included in protocol version 1.1.
149
150  7. Channel Message Payload needs slight redesining to include the IV
151     field to the MAC generation of the payload.  It is authenticated
152     by the packet's MAC but not by the payload's MAC.  Since the IV
153     belongs to the payload, its integrity should be protected by the
154     payload MAC and not alone by packet MAC.  To be included in protocol 
155     version 1.1.
156
157  8. Remove the administrative commands from the protocol all together.
158     It does not make sense for the protocol to define how a server is
159     reconnected or shutdown, since they are implementation and 
160     configuration issues.  Besides protocol provides only limited set of
161     administrative commands and cannot define all that one could imagine.
162     To be included in protocol version 1.1.
163
164  9. Add SILC_MESAGE_FLAG_REPLY for being other side to the
165     SILC_MESSAGE_FLAG_REQUEST.  Add generic SILC_MESSAGE_FLAG_DATA, which
166     can include generic payload, which can include generic data.  The
167     payload definition is left out for now.  To be included in protocol
168     version 1.1.
169
170  10. Check command reply error status types in various commands,
171      specifically NO_FOPRIV is missing from many commands.  To be 
172      included in protocol version 1.1.
173
174
175 TODO After 1.0
176 ==============
177
178 A rough list of stuff that is going to be done to SILC after 1.0 or at
179 least could be done.
180
181  o Implement the defined SilcDH API.  The definition is in
182    lib/silccrypt/silcdh.h.
183
184  o X.509 certificate support.  SILC protocol supports certificates and
185    it would be great to have support for them.  This is a big task as
186    support has to be made for ASN.1 as well.  I've looked into OpenSSL 
187    package as it has X.509 certificate support (and ASN.1 as well).  
188    The code does not look very good to my eye but it has some potentials.
189    This should be looked at more closely.
190
191    Naturally own SILC Certificate API has to be defined regardles what
192    the actual X.509 library is (OpenSSL X.509 or something else).  Other
193    choice is to write own X.509 library but I'm not going to do it - 
194    I can help to migrate the OpenSSL X.509 into SILC and I can help if 
195    someone would like to write the X.509 library - but I'm not going 
196    to start writing one myself.  Anyhow, the OpenSSL X.509 lib should
197    be checked.
198
199    Other package that should be checked is the NSS's X509 library,
200    which I like more over OpenSSL package.
201
202  o SSH2 public keys support, allowing the use of SSH2 public keys in
203    SILC.
204
205  o OpenPGP certificate support, allowing the use of PGP public keys
206    in SILC.
207
208  o Compression routines are missing.  The protocol supports packet
209    compression thus it must be implemented.  SILC Zip API must be
210    defined.
211
212  o Rewrite the lib/silcutil/silcprotocol.[ch] not to have [un]register 
213    functions, but to make it context based all the way.  The alloc should 
214    take as argument the protocol type and its callback (not only 
215    final callback).  It is not good that we have now global list of 
216    registered protocols.
217
218  o Optimizations in Libraries
219
220         o There is currently three (3) allocations per packet in the
221           silc_packet_receive_process, which is used to process and
222           dispatch all packets in the packet queue to the parser callback
223           function.  First allocation is for parse_ctx, second for the
224           SilcPacketContext, and third for packet->buffer where the actual
225           data is saved.
226
227           The parse_ctx allocation can be removed by adding it as a
228           structure to the SilcPacketContext.  When the SilcPacketContext
229           is allocated there is space for the parse context already.
230
231           The silc_packet_context_alloc could have a free list of
232           packet contexts.  If free packet context is found from the list
233           it is returned instead of allocating a new one.  The library
234           could at first allocate them and save them to the free list
235           until enough contexts for smooth processing exists in the list.
236           This would remove a big allocation since the structure is
237           quite big, and even bigger if it would include the parse_ctx.
238
239           The packet->buffer can be optimized too if the SilcBuffer
240           interface would support free lists as well.  Maybe such could
241           be done in the same way as for SilcPacketContext.  The
242           silc_buffer_alloc would check free list before actually 
243           allocating new memory.  Since the packets in the SILC protocol
244           usually are about the same size (due to padding) it would be
245           easy to find suitable size buffer from the free list very
246           quickly.
247
248           These naturally cause the overal memory consumption to grow
249           but would take away many allocations that can be done several
250           times in a second.
251
252         o Move the actual file descriptor task callback (the callback that
253           handles the incoming data, outgoing data etc, that is implemnted
254           in server and client separately (silc_server_packet_process and
255           silc_client_packet_proces)) to the low level socket connection
256           handling routines, and create an interface where the application
257           can register a callbacks for incoming data, outoing data and EOF
258           receiving, which the library will call when necessary.  This way 
259           we can move the data handling in one place.
260
261         o Add silc_id_str2id to accept the destination buffer as argument
262           and thus not require any memory allocation.  Same will happen
263           with silc_id_payload_* functions.
264
265  o Optimizations in Server
266
267         o Remove the big switch statement from the function 
268           silc_server_packet_parse_type and replace it with predefined
269           table of function pointers where each of the slot in table
270           represents the packet type value.
271
272           Same could be done with notify packets which has big switch 
273           statement too.  Same kind of table of notify callbacks could be
274           done as well.
275
276         o The parser callback in the server will add a timeout task for
277           all packets.  It will require registering and allocating a
278           new task to the SilcSchedule.  Maybe, at least, for server
279           and router packets the parser would be called immediately
280           instead of adding it to the scheduler with 0 timeout.  It
281           should be analyzed too how slow the task registering process
282           actually is, and find out ways to optimize it.
283
284  o Add SilcAsyncOperation to utility library.
285
286  o Cipher optimizations (asm, that this) at least for i386 would be nice.
287
288  o Add builtin SOCKS and HTTP Proxy support, well the SOCKS at least.
289    SILC currently supports SOCKS4 and SOCKS5 but it needs to be compiled
290    in separately.