7231181a248270c0dafd90b081fc36743ad68a95
[oweals/gnunet.git] / TODO
1 PHASE #1: (Goal: settle key design questions)
2
3 ARM:
4 * Make sure ARM supports daemons (non-service background processes, see hostlist/topology)
5
6 Util:
7 * improve disk API [Nils]
8 * Windows: use events instead of pipes to signal select()s [Nils]
9 * only connect() sockets that are ready (select())
10   [Nils: I'm not sure what you mean by this; fresh sockets are always
11    ready for connect(), just 'write' after connect needs select AFAIK;
12    please clarify. --Christian]
13
14 TESTCASES WANTED:
15 For these functions, it would be nice if we had testcases ("make check")
16 that would cause them to be executed and check that they are working:
17 * gnunet-service-peerinfo:
18   - change_host_trust / flush_trust 
19   - remove_garbage / 
20   - discard_hosts_helper / cron_clean_data_hosts
21 * gnunet-service-transport:
22   - try_unvalidated_addresses
23   - lookup_address_callback
24   - lookup_hello_callback
25   - plugin_env_lookup_address
26   - notify_clients_disconnect
27   - list_validated_addresses
28   - cleanup_validation
29   - disconnect_neighbour
30   - handle_set_quota
31 * plugin_transport_tcp.c:
32   - tcp_plugin_cancel
33   - tcp_plugin_address_pretty_printer / append_port
34   - tcp_plugin_set_receive_quota
35   - delayed_done
36 * transport_api:
37   - GNUNET_TRANSPORT_set_qutoa / send_set_quota
38   - hello_wait_timeout 
39   - transmit_ready
40   - transmit_timeout
41   - remove_from_any_list / remove_neighbour
42   - GNUNET_TRANSPORT_notify_transmit_ready_cancel
43 * core_api:
44   - timeout_request
45   - solicit_traffic / copy_and_free
46   - GNUNET_CORE_peer_configure / produce_configure_message
47 * gnunet-service-core:
48   - update_window
49   - find_client
50   - handle_client_request_configure
51   - set_key_retry_task
52   - align_and_deliver
53   - handle_transport_notify_disconnect
54 * hostlist (everything)
55 * topology (everything)
56
57
58
59 PHASE #2: (Goal: recover basic file-sharing functionality)
60
61 Datastores:
62 * implement sqlite-based sqstore/datastore service
63   + implement library (talks to service)
64   + implement service (datastore + talks to plugin)
65   + implement sqlite plugin (talks to DB)
66 * implement sqlite-based dstore services
67   + implement library (talks to service)
68   + implement service (talks to plugin)
69   + implement sqlite plugin (talks to DB)
70
71 Applications:
72 * DHT, DV
73 * FS / fs-libs
74
75 Databases:
76 * have ONE backend working
77
78
79 PHASE #3: (Goal: ready for pre-release) [completion-goal: end of 2009]
80
81 * testing
82 * setup
83 * gtk, qt GUIs
84 * tbench
85 * tracekit
86 * vpn
87
88 Transports:
89 * UDP backend (need LIBRARY to support (de)fragmentation!)
90 * HTTP backend
91 * Testing:
92   +  Testcases for set_quota, timeouts, disconnects, transmit_ready_cancel
93   + Better coverage of gnunet-service-transport (hello validation)
94   + direct test of plugins compliance to plugin API
95
96 Databases:
97 * sqlite, mysql & postgres backend
98
99
100
101 Minor TODO items:
102 * UTIL:
103   - crypto_hash: use libgcrypt (supports SHA-512 since 2003)
104   - container_bloomfilter: improve efficiency (see FIXME)
105 * SERVER:
106   - inefficient memmove
107 * TRANSPORT:
108   - transport_api: support forcing disconnects through low quotas!
109     (required for working F2F support!)
110   - API: consider having core provide deadline information for each message
111     (likely important for DV plugin which wants to loop back!)
112   - implement transport API to pretty-print transport address 
113     + transport_api extension (API extension!)
114     + service-transport extension (protocol extension)
115   - add calls to statistics in various places
116   - implement gnunet-transport (transport configurator / tester)
117   - UPnP-based IP detection
118     (Note: build library always, build service when libxml2/etc. are available)
119   - instantly filter addresses from *other* peers that 
120     are *equal* to our own address + port (i.e., localhost:2086).  We 
121     no longer filter those for outgoing (helps with loopback testing
122     and keeps the code clean), but we should filter strictly *impossible*
123     incoming addresses!  This is for efficiency, not correctness.
124   - We currently are happy to take any address told to us in a WELCOME
125     to our set of addresses; we should have some minimal threshold-based
126     scheme, limiting both the total number of addresses that we accept 
127     this way as well as requiring multiple confirmations; also, we
128     should possibly try to confirm that the given address works for
129     us ourselves (loopback-style) before adding it to the list
130     [SECURITY issue]
131   - not sure current way of doing ACKs works well-enough 
132     with unreliable transports where the ACK maybe lost;
133     the "is_new" check would then possibly prevent future
134     ACKs to be delivered, all while we're happily 
135     receiving messages from that peer!  Worse, the other
136     peer won't generate another ACK since it thinks we're
137     connected just fine...
138     Key questions:
139     + How necessary is ACKing in the first place? (alternatives?)
140     + Should we transmit ACKs in response to every HELLO? (would that 
141       fully address the problem?)
142   - latency measurements implemented in the transport
143     plugins makes it only work for bi-di transports
144     and results in code replication
145   - should latency be included in the ReceiveCallback and
146     NotifyConnect or passed on request?
147 * SETUP:
148   - auto-generate "defaults.conf" using gnunet-setup from "config.scm"
149   - integrate all options into "config.scm"
150   - change config-file writing to exclude options set to default values
151 * ARM:
152   - implement exponential back-off for service restarts
153   - better tracking of which config changes actually need to cause process restarts by ARM.
154   - have way to specify dependencies between services (to manage ARM restarts better)
155 * PEERINFO:
156   - have gnunet-peerinfo print actual host addresses again
157   - add option to gnunet-peerinfo to modify trust value
158 * POSTGRES-DB:
159   - finish postgres implementation; simplify other SQLs using new stats
160 * HTTPS transport
161   - PolariSSL for MHD?
162   - https integration
163 * GAP improvements:
164   - active reply route caching design & implementation of service,
165     gap extension!
166 * HOSTLIST:
167   - implement advertising of hostlist URL
168   - implement learning of hostlist URLs
169
170
171
172 => PRE-RELEASE
173
174 PHASE #4: [completion-goal: mid 2010]
175 * Documentation
176 * new webpage
177
178
179
180
181 Stuff to remember:
182 * Features eliminated from util:
183   - threading (goal: good riddance!)
184   - complex logging features [ectx-passing, target-kinds] (goal: good riddance!)
185   - complex configuration features [defaults, notifications] (goal: good riddance!)
186   - network traffic monitors (goal: eliminate)
187   - IPC semaphores (goal: d-bus? / eliminate?)
188   - second timers
189   - DNS lookup (goal: have async service; issue: still need synchronous resolution in places, current code may not be portable)
190   => code shrunk from 61 files to 34, 22k LOC to 15k LOC, 470k to 330k (with symbols)
191 * New features in util:
192   - scheduler
193   - service and program boot-strap code
194 * Major changes in util:
195   - more expressive server (replaces selector)
196 * Open questions: 
197   - how to integrate scheduler with GTK event loop!
198
199
200
201 Test coverage:
202 * UTIL      : 78.7%
203 * HELLO     : 93.7%
204 * ARM       : 69.9%
205 * RESOLVER  : 60.4%
206 * STATISTICS: 82.8%
207 * PEERINFO  : 71.5%
208 * TRANSPORT : 70.9%
209 * CORE      : 65.8%
210 ===================
211 * TOTAL     : 74.9%
212
213 Not yet tested:
214 * HOSTLIST  :  0.0%
215 * TOPOLOGY  :  0.0%