r18891@catbus: nickm | 2008-03-17 13:20:20 -0400
[tor.git] / doc / TODO
bloba0f5134039568a380643125382285feb5c666191
1 $Id$
2 Legend:
3 SPEC!!  - Not specified
4 SPEC    - Spec not finalized
5 N       - nick claims
6 R       - arma claims
7 P       - phobos claims
8 S       - Steven claims
9 M       - Matt/Mike claims
10 J       - Jeff claims
11 I       - ioerror claims
12         - Not done
13         * Top priority
14         . Partially done
15         o Done
16         d Deferrable
17         D Deferred
18         X Abandoned
20 =======================================================================
22 External constraints:
23   - Mid Feb, blocking-resistance roll-out
24 M   - Adequately stable Vidalia snapshot, or 0.1.0 release
25 R   - Write some text for it
26 S   - New Tor Browser Bundle with above Vidalia
28   - Late Feb, NGO in a box
29     - Have 0.2.0 beta or rc out
31   - Mid Mar, upnp
32 S   - Pick a suitable-looking upnp library and begin integrating it
34   - Mid Apr
35     - More Torbrowser work:
36       o Get polipo into it
37 ?     - Resolve branding issue
38       o Make Torbrowser website
39 R     - Get it integrated into the Tor download pages
40 S   - Finish first cut at integrating upnp lib into Vidalia
41 R   - get the geoip files onto some bridge relays, and gather stats
43   - End of April
44 S   - Zip-splitting:
45       - Document the use of 7-zip to combine fractional files and
46         reconstruct them after download.  Host such files.
47       - If it's faster to research a self-extracting splitter
48         and use it, with simpler documentation, that's obviously fine.
49 N   - Investigate and start resolving (or declare unresolvable) the ram
50       issue for relays. Investigate and document all of, and do at
51       least two of:
52       o better buffer approaches in Tor
53       - better buffer approaches in openssl
54       - shipping Tor with its own integrated allocator.
55 N   - Write a draft research proposal for how to safely collect and
56       aggregate some GeoIP data from non-bridge entry nodes, or conclude
57       that we don't know how to do it safely while still being useful
58       and explain why.
59 I   - Translation portal
60       - Vidalia translations (via launchpad?)
61       - Vidalia installer translations
62       - Torbutton translations (via babelzilla?)
63       - Centralized instructions for how to help translate
64       - Continue managing the tor-translations team to keep the Tor
65         website translated
67   - End of May
68 S   - More TorBrowser work
69       - Integrate pidgin and OTR
70       - move portablefirefox nsi goo into vidalia as appropriate
71       - Figure out (or give up on) how to run Tor Browser and ordinary
72         Firefox side-by-side.
74   - mid June
75 R   - SRI stuff
77   - mid June
78     - More TorBrowser work
79 S     - Firefox extension framework for Torbrowser build-time
80 S     - Progress bar during startup, including some "timeout" events to
81         indicate when Tor's unlikely to succeed at startup.
82 R       - Make Tor put out appropriate events
83         - Let Vidalia notice them and change its appearance
84 S     - Enumerate and analyze traces left when running from USB
85 R   - Finish tor-doc-bridge.wml
86     - More bridgedb work:
87 R     - Get the dkimproxy patch in
88 ?     - Brainstorm about safe but effective ways for vidalia to
89         auto-update its user's bridges via Tor in the background.
90 NR    - Include "stable" bridge and "port 443" bridge and "adequately
91         new version" bridge free in every specially marked
92         box!^W^W^Woutput batch.
93 N     - Detect proxies and treat them as the same address
94     - More back-end work:
95 N     - If we decided above that we know how to collect geoip data for
96         non bridge relays, deploy that plan.
97 N     - Additional TLS-camouflage work (spoofing FF cipher suite, etc.)
98         - spoof the cipher suites
99         - spoof the extensions list
100         - red-team testing (a.k.a, look at a packet dump and compare),
101         - investigate the feasibility of handing connections off to a
102           local apache if they don't look like Tor or if they don't
103           portknock or whatever.
104 R     - Get closer to downloading far fewer descriptors
105         - Instrument the code to track how many descriptors we download vs how
106           many times we extend a circuit.
107         - Write a proposal for how to fetch far fewer descriptors; assess
108           anonymity attacks, like from looking at the size of the
109           descriptor you fetch.
110 I     - Translation portal
111         - Torbutton webpage
112         o Torbrowser webpage
113         - Tor website
114         - check.torproject.org
116   - August
117 I   - Auto update
118       o Vidalia learns when Tor thinks it should be updated
119 R     - Tor status events should suggest a new version to switch to
120 I     - Figure out a good PKI, document the design, assess security issues:
121         "write a proposal"
122       - Vidalia fetches the new one via Tor when possible, but fetches
123         it without Tor "when necessary", whatever that means.
124         - Give an interface for notifying the user, and letting her
125           decide to fetch and decide to swap out the old Tor for the new.
126       - Do the same for Polipo
127       - and for Vidalia itself
129 =======================================================================
131 For Tor 0.2.0.x-rc:
132 R - Figure out the autoconf problem with adding a fallback consensus.
133 R - add a geoip file
134 W   - figure out license
135 R - let bridges set relaybandwidthrate as low as 5kb
136 R - bug: if we launch using bridges, and then stop using bridges, we
137     still have our bridges in our entryguards section, and may use them.
138   . make it easier to set up a private tor network on your own computer
139     is very hard.
140 R   . FAQ entry which is wrong
141   o Make BEGIN_DIR mandatory for asking questions of bridge authorities?
142     (but only for bridge descriptors. not for ordinary cache stuff.)
143     o Implement connection_dir_is_encrypted().
144     o set up a filter to not answer any bridge descriptors on a
145       non-encrypted request
146   o write a tor-gencert man page
148 N . geoip caching and publishing for bridges
149     d Track consecutive time up, not time since last-forgotten IP.
150     - Mention in dir-spec.txt
151     - Mention in control-spec.txt
152     D have normal relays report geoip stats too.
153     D different thresholds for bridges than for normal relays.
154     o bridge relays round geoip stats *up*, not down.
155 R - bridge communities
156     . spec
157     . deploy
158       - man page entries for Alternate*Authority config options
160 Things we'd like to do in 0.2.0.x:
161   o if we notice a cached-status directory and we're not serving v2 dir
162     info and it's old enough, delete it.
163      o same with cached-routers*.
164 N - document the "3/4 and 7/8" business in the clients fetching consensus
165     documents timeline.
166 R   - then document the bridge user download timeline.
168 N - Before the feature freeze:
169     - 105+TLS, if possible.
170       . TLS backend work
171         . Enable.
172       - Test
173         o Verify version negotiation on client
174         o Verify version negotiation on server
175         o Verify that client->server connection becomes open
176         - Verify that server->server connection becomes open and
177           authenticated.
178         - Verify that initiator sends no cert in first stage of TLS
179           handshake.
180       - NETINFO fallout
181         - Don't extend a circuit over a noncanonical connection with
182           mismatched address.
183         - Learn our outgoing IP address from netinfo cells?
185   - Bugs.
186      - Bug reports Roger has heard along the way that don't have enough
187         details/attention to solve them yet.
188         - arma noticed that when his network went away and he tried
189           a new guard node and the connect() syscall failed to it,
190           the guard wasn't being marked as down. 0.2.0.x.
191         - after being without network for 12 hours, arma's tor decided
192           it couldn't fetch any network statuses, and never tried again
193           even when the network came back and arma clicked on things.
194           also 0.2.0.
195 R       - for above two, roger should turn them into flyspray entry.
197   - Proposals:
198     o 101: Voting on the Tor Directory System (plus 103)
199 N     - Use if-modified-since on consensus download
200       - Controller support
201         D GETINFO to get consensus
202 N       - Event when new consensus arrives
203     . 111: Prioritize local traffic over relayed.
204 R     - Merge into tor-spec.txt.
206   - Refactoring:
207     . Make cells get buffered on circuit, not on the or_conn.
208       . Switch to pool-allocation for cells?
209 N       - Benchmark pool-allocation vs straightforward malloc.
210 N       - Adjust memory allocation logic in pools to favor a little less
211           slack memory.
212     . Remove socketpair-based bridges conns, and the word "bridge".  (Use
213       shared (or connected) buffers for communication, rather than sockets.)
214       . Implement
215 N       - Handle rate-limiting on directory writes to linked directory
216           connections in a more sensible manner.
217           Nick thinks he did this already?
218 N       - Find more ways to test this.
219           (moria doesn't rate limit, so testing on moria not so good.)
221   - Documentation
222     - HOWTO for DNSPort. See tup's wiki page.
223     . Document transport and natdport in a good HOWTO.
224 N   - Quietly document NT Service options: revise (or create) FAQ entry
226 R - make sure you solved bug 556
228 P - Make documentation realize that location of system configuration file
229     will depend on location of system defaults, and isn't always /etc/torrc.
230 P - Figure out why dll's compiled in mingw don't work right in WinXP.
231 P - create a "make win32-bundle" for vidalia-privoxy-tor-torbutton bundle
233 =======================================================================
235 Planned for 0.2.1.x:
236   - Things that have been bugging Nick
237     - Make better use of multi-core machines: Do AES crypto and
238       compression in worker threads
239     - Maybe use jemalloc from freebsd via firefox 3, once its windows
240       and osx ports are more mature.
241     - MMap the cached-descriptors.new file as well as the regular ones
242     - Actually use SSL_shutdown to close our TLS connections.
243     - Refactor the HTTP logic so the functions aren't so large.
244     - Get a "use less buffer ram" patch into openssl.
245     - Get IOCP patch into libevent
246     - Use libevent's evdns code where applicable.
247     - Refactor buf_read and buf_write to have sensible ways to return
248       error codes after partial writes
249     - Improve unit test coverage
250     - Logging domains.
252   - get rid of the v1 directory stuff (making, serving, and caching).
253     - perhaps replace it with a "this is a tor server" stock webpage.
254   - even clients run rep_hist_load_mtbf_data(). this wastes memory.
255   - steven's plan for replacing check.torproject.org with a built-in
256     answer by tor itself.
257   - a status event for when tor decides to stop fetching directory info
258     if the client hasn't clicked recently: then make the onion change too.
260   - bridge communities with local bridge authorities:
261     - clients who have a password configured decide to ask their bridge
262       authority for a networkstatus
263     - be able to have bridges that aren't in your torrc. save them in
264       state file, etc.
265   - router_choose_random_node() has a big pile of args. make it "flags".
266   - Consider if we can solve: the Tor client doesn't know what flags
267     its bridge has (since it only gets the descriptor), so it can't
268     make decisions based on Fast or Stable.
269   - anonymity concern: since our is-consensus-fresh-enough check is
270     sloppy so clients will actually work when a consensus wasn't formed,
271     does that mean that if users are idle for 5 hours and then click on
272     something, we will immediately use the old descriptors we've got,
273     while we try fetching the newer descriptors?
274     related to bug 401.
275   . Finish path-spec.txt
276   - More prominently, we should have a recommended apps list.
277     - recommend pidgin (gaim is renamed)
278     - unrecommend IE because of ftp:// bug.
279   - we should add a preamble to tor-design saying it's out of date.
280   - Refactor networkstatus generation:
281     - Include "v" line in getinfo values.
282   - config option __ControllerLimit that hangs up if there are a limit
283     of controller connections already.
284   - Features (other than bridges):
285     - Audit how much RAM we're using for buffers and cell pools; try to
286       trim down a lot.
287     - Base relative control socket paths on datadir.
288     - Make TrackHostExits expire TrackHostExitsExpire seconds after their
289        *last* use, not their *first* use.
290   - Plan a switch to polipo.  Perhaps we'll offer two http proxies in
291     the future.
292   - Consider creating special Tor-Polipo-Vidalia test packages,
293     requested by Dmitri Vitalev (does torbrowser meet this need?)
294   - Create packages for Nokia 800, requested by Chris Soghoian
295   - mirror tor downloads on (via) tor dir caches
296     . spec
297     - deploy
298   - interface for letting soat modify flags that authorities assign
299     . spec
300   - proposal 118 if feasible and obvious
301   - Maintain a skew estimate and use ftime consistently.
302   - Tor logs the libevent version on startup, for debugging purposes.
303     This is great. But it does this before configuring the logs, so
304     it only goes to stdout and is then lost.
305   - Deprecations:
306     - can we deprecate 'getinfo network-status'?
307     - can we deprecate the FastFirstHopPK config option?
308   - Bridges:
309     . Bridges users (rudimentary version)
310       . Ask all directory questions to bridge via BEGIN_DIR.
311         - use the bridges for dir fetches even when our dirport is open.
312       - drop 'authority' queries if they're to our own identity key; accept
313         them otherwise.
314       - give extend_info_t a router_purpose again
315   d Limit to 2 dir, 2 OR, N SOCKS connections per IP.
316     - Or maybe close connections from same IP when we get a lot from one.
317     - Or maybe block IPs that connect too many times at once.
318   - Do TLS connection rotation more often than "once a week" in the
319     extra-stable case.
320   - Streamline how we pick entry nodes: Make choose_random_entry() have
321     less magic and less control logic.
322   - when somebody uses the controlport as an http proxy, give them
323     a "tor isn't an http proxy" error too like we do for the socks port.
324   - we try to build 4 test circuits to break them over different
325     servers. but sometimes our entry node is the same for multiple
326     test circuits. this defeats the point.
327   - enforce a lower limit on MaxCircuitDirtiness and CircuitBuildTimeout.
328   - configurable timestamp granularity. defaults to 'seconds'.
329   - consider making 'safelogging' extend to info-level logs too.
330   - we should consider a single config option TorPrivateNetwork that
331     turns on all the config options for running a private test tor
332     network. having to keep updating all the tools, and the docs,
333     just isn't working.
334   - consider whether a single Guard flag lets us distinguish between
335     "was good enough to be a guard when we picked it" and "is still
336     adequate to be used as a guard even after we've picked it". We should
337     write a real proposal for this.
338   - switch out privoxy in the bundles and replace it with polipo.
339   - make the new tls handshake blocking-resistant.
340   - figure out some way to collect feedback about what countries are using
341     bridges, in a way that doesn't screw anonymity too much.
342   - let tor dir mirrors proxy connections to the tor download site, so
343     if you know a bridge you can fetch the tor software.
344   - more strategies for distributing bridge addresses in a way that
345     doesn't rely on knowing somebody who runs a bridge for you.
346   - A way to adjust router status flags from the controller.  (How do we
347     prevent the authority from clobbering them soon afterward?)
348   - Bridge authorities should do reachability testing but only on the
349     purpose==bridge descriptors they have.
350   - Clients should estimate their skew as median of skew from servers
351     over last N seconds.
352   - Investigate RAM use in Tor servers.
353   - Start on the WSAENOBUFS solution.
354   - Start on Windows auto-update for Tor
355   - Stuff that weasel wants:
356     - Make Tor able to chroot itself
357       o allow it to load an entire config file from control interface
358       - document LOADCONF
359       - log rotation (and FD passing) via control interface
360       - chroot yourself, including inhibit trying to read config file
361         and reopen logs, unless they are under datadir.
363 Deferred from 0.2.0.x:
364   - Proposals
365     - 113: Simplifying directory authority administration
366     - 110: prevent infinite-length circuits (phase one)
367     - 118: Listen on and advertise multiple ports:
368       - Tor should be able to have a pool of outgoing IP addresses that it is
369         able to rotate through. (maybe.  Possible overlap with proposal 118.)
370       - config option to publish what ports you listen on, beyond
371         ORPort/DirPort.  It should support ranges and bit prefixes (?) too.
372         (This is very similar to proposal 118.)
373     - 117: IPv6 Exits
374       - Internal code support for ipv6:
375         o Clone ipv6 functions (inet_ntop, inet_pton) where they don't exist.
376         - Most address variables need to become tor_addr_t
377         - Teach resolving code how to handle ipv6.
378         - Teach exit policies about ipv6 (consider ipv4/ipv6 interaction!)
379   - Features
380     - Let controller set router flags for authority to transmit, and for
381       client to use.
382     - add an 'exit-address' line in the descriptor for servers that exit
383       from something that isn't their published address.
384     - More work on AvoidDiskWrites?
385   - Features
386     - Make a TCP DNSPort
387   - Protocol work
388     - MAYBE kill stalled circuits rather than stalled connections.  This is
389       possible thanks to cell queues, but we need to consider the anonymity
390       implications.
391     - Implement TLS shutdown properly when possible.
392   - Bugs
393     - If the client's clock is too far in the past, it will drop (or just not
394       try to get) descriptors, so it'll never build circuits.
395   - Refactoring
396     - Make resolves no longer use edge_connection_t unless they are actually
397       _on_ a socks connection: have edge_connection_t and (say)
398       dns_request_t both extend an edge_stream_t, and have p_streams and
399       n_streams both be linked lists of edge_stream_t.
400     - Generate torrc.{complete|sample}.in, tor.1.in, the HTML manual, and the
401       online config documentation from a single source.
402     - Move all status info out of routerinfo into local_routerstatus.  Make
403       "who can change what" in local_routerstatus explicit.  Make
404       local_routerstatus (or equivalent) subsume all places to go for "what
405       router is this?"
406   - Blocking/scanning-resistance
407     - It would be potentially helpful to respond to https requests on
408       the OR port by acting like an HTTPS server.
409     - Do we want to maintain our own set of entryguards that we use as
410       next hop after the bridge? Open research question; let's say no
411       for 0.2.0 unless we learn otherwise.
412     - Some mechanism for specifying that we want to stop using a cached
413       bridge.
414   - Build:
415     - Detect correct version of libraries from autoconf script.
417 =======================================================================
419 Future versions:
420   - deprecate router_digest_is_trusted_dir() in favor of
421     router_get_trusteddirserver_by_digest()
423   - See also Flyspray tasks.
424   - See also all OPEN/ACCEPTED proposals.
425   - See also all items marked XXXX and FFFF in the code.
427   - Protocol:
428     - Our current approach to block attempts to use Tor as a single-hop proxy
429       is pretty lame; we should get a better one.
430     - Allow small cells and large cells on the same network?
431     - Cell buffering and resending. This will allow us to handle broken
432       circuits as long as the endpoints don't break, plus will allow
433       connection (tls session key) rotation.
434     - Implement Morphmix, so we can compare its behavior, complexity,
435       etc.  But see paper breaking morphmix.
436     - Other transport. HTTP, udp, rdp, airhook, etc. May have to do our own
437       link crypto, unless we can bully DTLS into it.
438     - Need a relay teardown cell, separate from one-way ends.
439       (Pending a user who needs this)
440     - Handle half-open connections: right now we don't support all TCP
441       streams, at least according to the protocol. But we handle all that
442       we've seen in the wild.
443       (Pending a user who needs this)
445   - Directory system
446     - BEGIN_DIR items
447       X turn the received socks addr:port into a digest for setting .exit
448       - handle connect-dir streams that don't have a chosen_exit_name set.
449     - Have a "Faster" status flag that means it. Fast2, Fast4, Fast8?
450     - Add an option (related to AvoidDiskWrites) to disable directory
451       caching.  (Is this actually a good idea??)
452     - Add d64 and fp64 along-side d and fp so people can paste status
453       entries into a url. since + is a valid base64 char, only allow one
454       at a time. Consider adding to controller as well.
455     - Some back-out mechanism for auto-approval on authorities
456       - a way of rolling back approvals to before a timestamp
457         - Consider minion-like fingerprint file/log combination.
458     - Have new people be in limbo and need to demonstrate usefulness
459       before we approve them.
461   - Hidden services:
462     - Standby/hotswap/redundant hidden services.
463     . Update the hidden service stuff for the new dir approach.  (Much
464       of this will be superseded by 114.)
465       - switch to an ascii format, maybe sexpr?
466       - authdirservers publish blobs of them.
467       - other authdirservers fetch these blobs.
468       - hidserv people have the option of not uploading their blobs.
469       - you can insert a blob via the controller.
470       - and there's some amount of backwards compatibility.
471       - teach clients, intro points, and hidservs about auth mechanisms.
472       - come up with a few more auth mechanisms.
473     - auth mechanisms to let hidden service midpoint and responder filter
474       connection requests.
475     - Let each hidden service (or other thing) specify its own
476       OutboundBindAddress?
477     - Hidserv offerers shouldn't need to define a SocksPort
479   - Server operation
480     X When we notice a 'Rejected: There is already a named server with
481       this nickname' message... or maybe instead when we see in the
482       networkstatuses that somebody else is Named with the name we
483       want: warn the user, send a STATUS_SERVER message, and fall back
484       to unnamed.
485     - If the server is spewing complaints about raising your ulimit -n,
486       we should add a note about this to the server descriptor so other
487       people can notice too.
488     - When we hit a funny error from a dir request (eg 403 forbidden),
489       but tor is working and happy otherwise, and we haven't seen many
490       such errors recently, then don't warn about it.
492   - Controller
493     - Implement missing status events and accompanying getinfos
494       - DIR_REACHABLE
495       - BAD_DIR_RESPONSE (Unexpected directory response; maybe we're behind
496         a firewall.)
497       - BAD_PROXY (Bad http or https proxy)
498       - UNRECOGNIZED_ROUTER (a nickname we asked for is unavailable)
499       - Status events related to hibernation
500       - something about failing to parse our address?
501         from resolve_my_address() in config.c
502       - sketchy OS, sketchy threading
503       - too many onions queued: threading problems or slow CPU?
504     - Implement missing status event fields:
505       - TIMEOUT on CHECKING_REACHABILITY
506     - GETINFO status/client, status/server, status/general: There should be
507       some way to learn which status events are currently "in effect."
508       We should specify which these are, what format they appear in, and so
509       on.
510     - More information in events:
511       - Include bandwidth breakdown by conn->type in BW events.
512       - Change circuit status events to give more details, like purpose,
513         whether they're internal, when they become dirty, when they become
514         too dirty for further circuits, etc.
515       - Change stream status events analogously.
516     - Expose more information via getinfo:
517       - import and export rendezvous descriptors
518       - Review all static fields for additional candidates
519     - Allow EXTENDCIRCUIT to unknown server.
520       - We need some way to adjust server status, and to tell tor not to
521         download directories/network-status, and a way to force a download.
522       - Make everything work with hidden services
524   - Performance/resources
525     - per-conn write buckets
526     - separate config options for read vs write limiting
527       (It's hard to support read > write, since we need better
528        congestion control to avoid overfull buffers there.  So,
529        defer the whole thing.)
530     - Look into pulling serverdescs off buffers as they arrive.
531     - Rate limit exit connections to a given destination -- this helps
532       us play nice with websites when Tor users want to crawl them; it
533       also introduces DoS opportunities.
534     - Consider truncating rather than destroying failed circuits,
535       in order to save the effort of restarting.  There are security
536       issues here that need thinking, though.
537     - Handle full buffers without totally borking
538     - Rate-limit OR and directory connections overall and per-IP and
539       maybe per subnet.
541   - Misc
542     - Hold-open-until-flushed now works by accident; it should work by
543       design.
544     - Display the reasons in 'destroy' and 'truncated' cells under
545       some circumstances?
546     - Make router_is_general_exit() a bit smarter once we're sure what
547       it's for.
548     - Automatically determine what ports are reachable and start using
549       those, if circuits aren't working and it's a pattern we
550       recognize ("port 443 worked once and port 9001 keeps not
551       working").
553   - Security
554     - some better fix for bug #516?
555     - don't do dns hijacking tests if we're reject *:* exit policy?
556       (deferred until 0.1.1.x is less common)
557     - Directory guards
558     - Mini-SoaT:
559       - Servers might check certs for known-good ssl websites, and if
560         they come back self-signed, declare themselves to be
561         non-exits.  Similar to how we test for broken/evil dns now.
562       - Authorities should try using exits for http to connect to some
563         URLS (specified in a configuration file, so as not to make the
564         List Of Things Not To Censor completely obvious) and ask them
565         for results.  Exits that don't give good answers should have
566         the BadExit flag set.
567       - Alternatively, authorities should be able to import opinions
568         from Snakes on a Tor.
569     - More consistent error checking in router_parse_entry_from_string().
570       I can say "banana" as my bandwidthcapacity, and it won't even squeak.
571     - Bind to random port when making outgoing connections to Tor servers,
572       to reduce remote sniping attacks.
573     - Audit everything to make sure rend and intro points are just as
574       likely to be us as not.
575     - Do something to prevent spurious EXTEND cells from making
576       middleman nodes connect all over.  Rate-limit failed
577       connections, perhaps?
578     - DoS protection: TLS puzzles, public key ops, bandwidth exhaustion.
580   - Needs thinking
581     - Now that we're avoiding exits when picking non-exit positions,
582       we need to consider how to pick nodes for internal circuits. If
583       we avoid exits for all positions, we skew the load balancing. If
584       we accept exits for all positions, we leak whether it's an
585       internal circuit at every step. If we accept exits only at the
586       last hop, we reintroduce Lasse's attacks from the Oakland paper.
588   - Windows server usability
589     - Solve the ENOBUFS problem.
590       - make tor's use of openssl operate on buffers rather than sockets,
591         so we can make use of libevent's buffer paradigm once it has one.
592       - make tor's use of libevent tolerate either the socket or the
593         buffer paradigm; includes unifying the functions in connect.c.
594     - We need a getrlimit equivalent on Windows so we can reserve some
595       file descriptors for saving files, etc. Otherwise we'll trigger
596       asserts when we're out of file descriptors and crash.
597     - Merge code from Urz into libevent
598     - Make Tor use evbuffers.
600   - Documentation
601     - a way to generate the website diagrams from source, so we can
602       translate them as utf-8 text rather than with gimp. (svg? or
603       imagemagick?)
604     . Flesh out options_description array in src/or/config.c
605     . multiple sample torrc files
606     . figure out how to make nt service stuff work?
607       . Document it.
608     - Refactor tor man page to divide generally useful options from
609       less useful ones?
610     - Add a doxygen style checker to make check-spaces so nick doesn't drift
611        too far from arma's undocumented styleguide.  Also, document that
612        styleguide in HACKING.  (See r9634 for example.)
613        - exactly one space at beginning and at end of comments, except i
614          guess when there's line-length pressure.
615        - if we refer to a function name, put a () after it.
616        - only write <b>foo</b> when foo is an argument to this function.
617        - doxygen comments must always end in some form of punctuation.
618        - capitalize the first sentence in the doxygen comment, except
619          when you shouldn't.
620        - avoid spelling errors and incorrect comments. ;)
622   - Packaging
623     - The Debian package now uses --verify-config when (re)starting,
624       to distinguish configuration errors from other errors. Perhaps
625       the RPM and other startup scripts should too?
626     - add a "default.action" file to the tor/vidalia bundle so we can
627       fix the https thing in the default configuration:
628       http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#PrivoxyWeirdSSLPort
630   - Related tools
631     - Patch privoxy and socks protocol to pass strings to the browser.
633 =======================================================================
635 Documentation, non-version-specific.
636   - Specs
637     - Mark up spec; note unclear points about servers
638 NR  - write a spec appendix for 'being nice with tor'
639     - Specify the keys and key rotation schedules and stuff
640   - Mention controller libs someplace.
641   - Remove need for HACKING file.
642   - document http://wiki.noreply.org/noreply/TheOnionRouter/TransparentProxy on freebsd and osx
643 P - figure out why x86_64 won't build rpms from tor.spec
644 P - figure out rpm spec files for bundles of vidalia-tor-polipo
645 P - figure out polipo install scripts for bundles of vidalia-tor-polipo on osx, win32
646   - figure out selinux policy for tor
647 P - change packaging system to more automated and specific for each
648      platform, suggested by Paul Wouter
649 P - Setup repos for redhat and suse rpms & start signing the rpms the
650     way package management apps prefer
652 Website:
653 J . tor-in-the-media page
654   - Which bundles include Torbutton? Change the docs/tor-doc-foo pages
655     so they admit that Torbutton is in them too. Change the download
656     page too.
657   - The OS X bundle screenshots are from forever ago -- they don't
658     include Torbutton, they still say it's tor.eff.org, etc.
659   - Should we still be telling you how to use Safari on OS X for Tor,
660     given all the holes that Torbutton-dev solves on Firefox?
661 P  - Figure out licenses for website material.
662     (Phobos reccomends the Open Publication License with Option A at
663     http://opencontent.org/openpub/)
664 P  - put the logo on the website, in source form, so people can put it on
665     stickers directly, etc.
666 P  - put the source image for the stickers on the website, so people can
667     print their own
668 P - figure out a license for the logos and docs we publish (trademark
669 figures into this)
670     (Phobos reccomends the Open Publication License with Option A at
671     http://opencontent.org/openpub/)
672 R - make a page with the hidden service diagrams.
673 P  - ask Jan/Jens to be the translation coordinator? add to volunteer page.
674 I - add a page for localizing all tor's components.
675   - It would be neat if we had a single place that described _all_ the
676     tor-related tools you can use, and what they give you, and how well they
677     work.  Right now, we don't give a lot of guidance wrt
678     torbutton/foxproxy/privoxy/polipo in any consistent place.
679 P - create a 'blog badge' for tor fans to link to and feature on their
680     blogs. A sample can be found at http://interloper.org/tmp/tor/tor-button.png
682   - Tor mirrors
683     - make a mailing list with the mirror operators
684     - make an automated tool to check /project/trace/ at mirrors to
685       learn which ones are lagging behind.
686     - auto (or manually) cull the mirrors that are broken; and
687       contact their operator?
688     - a set of instructions for mirror operators to make their apaches
689       serve our charsets correctly, and bonus points for language
690       negotiation.
691     - figure out how to load-balance the downloads across mirrors?
692     - ponder how to get users to learn that they should google for
693       "tor mirrors" if the main site is blocked.
694     - find a mirror volunteer to coordinate all of this