question
[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 * crypto_hash: use libgcrypt (supports SHA-512 since 2003)
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 * hostlist (everything)
56 * topology (everything)
57
58
59
60 PHASE #2: (Goal: recover basic file-sharing functionality)
61
62 Datastores:
63 * implement sqlite-based sqstore/datastore service
64   + implement library (talks to service)
65   + implement service (datastore + talks to plugin)
66   + implement sqlite plugin (talks to DB)
67 * implement sqlite-based dstore services
68   + implement library (talks to service)
69   + implement service (talks to plugin)
70   + implement sqlite plugin (talks to DB)
71
72 Applications:
73 * implement hostlist service (need to bootstrap!)
74 * DHT, DV
75 * FS / fs-libs
76
77 Databases:
78 * have ONE backend working
79
80
81 PHASE #3: (Goal: ready for pre-release) [completion-goal: end of 2009]
82
83 * testing
84 * setup
85 * gtk, qt GUIs
86 * tbench
87 * tracekit
88 * vpn
89
90 Transports:
91 * UDP backend (need LIBRARY to support (de)fragmentation!)
92 * HTTP backend
93 * Testing:
94   +  Testcases for set_quota, timeouts, disconnects, transmit_ready_cancel
95   + Better coverage of gnunet-service-transport (hello validation)
96   + direct test of plugins compliance to plugin API
97
98 Databases:
99 * sqlite, mysql & postgres backend
100
101
102
103 Minor TODO items:
104 * SERVER:
105   - inefficient memmove
106 * TRANSPORT:
107   - transport_api: support forcing disconnects through low quotas!
108   - API: consider having core provide deadline information for each message
109     (likely important for DV plugin which wants to loop back!)
110   - implement transport API to pretty-print transport address 
111     + transport_api extension (API extension!)
112     + service-transport extension (protocol extension)
113   - add calls to statistics in various places
114   - implement gnunet-transport (transport configurator / tester)
115   - UPnP-based IP detection
116     (Note: build library always, build service when libxml2/etc. are available)
117   - instantly filter addresses from *other* peers that 
118     are *equal* to our own address + port (i.e., localhost:2086).  We 
119     no longer filter those for outgoing (helps with loopback testing
120     and keeps the code clean), but we should filter strictly *impossible*
121     incoming addresses!  This is for efficiency, not correctness.
122   - We currently are happy to take any address told to us in a WELCOME
123     to our set of addresses; we should have some minimal threshold-based
124     scheme, limiting both the total number of addresses that we accept 
125     this way as well as requiring multiple confirmations; also, we
126     should possibly try to confirm that the given address works for
127     us ourselves (loopback-style) before adding it to the list
128     [SECURITY issue]
129   - not sure current way of doing ACKs works well-enough 
130     with unreliable transports where the ACK maybe lost;
131     the "is_new" check would then possibly prevent future
132     ACKs to be delivered, all while we're happily 
133     receiving messages from that peer!  Worse, the other
134     peer won't generate another ACK since it thinks we're
135     connected just fine...
136     Key questions:
137     + How necessary is ACKing in the first place? (alternatives?)
138     + Should we transmit ACKs in response to every HELLO? (would that 
139       fully address the problem?)
140   - latency measurements implemented in the transport
141     plugins makes it only work for bi-di transports
142     and results in code replication
143   - should latency be included in the ReceiveCallback and
144     NotifyConnect or passed on request?
145 * SETUP:
146   - auto-generate "defaults.conf" using gnunet-setup from "config.scm"
147   - integrate all options into "config.scm"
148   - change config-file writing to exclude options set to default values
149 * ARM:
150   - implement exponential back-off for service restarts
151   - better tracking of which config changes actually need to cause process restarts by ARM.
152   - have way to specify dependencies between services (to manage ARM restarts better)
153 * PEERINFO:
154   - have gnunet-peerinfo print actual host addresses again
155   - add option to gnunet-peerinfo to modify trust value
156 * POSTGRES-DB:
157   - finish postgres implementation; simplify other SQLs using new stats
158 * HTTPS transport
159   - PolariSSL for MHD?
160   - https integration
161 * GAP improvements:
162   - active reply route caching design & implementation of service,
163     gap extension!
164 * HOSTLIST:
165   - implement advertising of hostlist URL
166   - implement learning of hostlist URLs
167
168
169
170 => PRE-RELEASE
171
172 PHASE #4: [completion-goal: mid 2010]
173 * Documentation
174 * new webpage
175
176
177
178
179 Stuff to remember:
180 * Features eliminated from util:
181   - threading (goal: good riddance!)
182   - complex logging features [ectx-passing, target-kinds] (goal: good riddance!)
183   - complex configuration features [defaults, notifications] (goal: good riddance!)
184   - network traffic monitors (goal: eliminate)
185   - IPC semaphores (goal: d-bus? / eliminate?)
186   - second timers
187   - DNS lookup (goal: have async service; issue: still need synchronous resolution in places, current code may not be portable)
188   => code shrunk from 61 files to 34, 22k LOC to 15k LOC, 470k to 330k (with symbols)
189 * New features in util:
190   - scheduler
191   - service and program boot-strap code
192 * Major changes in util:
193   - more expressive server (replaces selector)
194 * Open questions: 
195   - how to integrate scheduler with GTK event loop!
196
197
198
199 Test coverage:
200 * UTIL: 75%, 4914 out of 6463