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