Remove dead code that was left from marking HiddenService(Exclude)Nodes obsolete...
[tor/rransom.git] / doc / TODO
blob4c6c723acb5f7ec244ed5110bbb34d22a258e87c
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 E       - Matt claims
10 M       - Mike claims
11 J       - Jeff claims
12 I       - ioerror claims
13 W       - weasel claims
14 K       - Karsten claims
15         - Not done
16         * Top priority
17         . Partially done
18         o Done
19         d Deferrable
20         D Deferred
21         X Abandoned
23 =======================================================================
25 External constraints:
27   - mid July
28 W   - Take the results from instrumenting directory downloads on Tor
29       clients, and analyze/simulate some alternate approaches. Finish
30       proposal for how to improve things, iterate based on feedback,
31       convince us that the anonymity tradeoffs and/or scalability
32       tradeoffs are acceptable.
34   - mid August
35 KS  - Design hidden service improvements, evaluate them and consider
36       security properties: write some proposals, get feedback, revise
37       them, etc.
38 ?   - nlnet 'user safety contest'. submit torbrowser, others?
40   - end of August
41 I   - Auto update
42       o Vidalia learns when Tor thinks it should be updated
43 R     - Tor status events should suggest a new version to switch to
44 I     - Figure out a good PKI, document the design, assess security issues:
45         "write a proposal"
46       - Vidalia fetches the new one via Tor when possible, but fetches
47         it without Tor "when necessary", whatever that means.
48         - Give an interface for notifying the user, and letting her
49           decide to fetch and decide to swap out the old Tor for the new.
50       - Do the same for Polipo
51       - and for Vidalia itself
53   - end of September
54 NSE - Write first draft of research study for Paul's research problem.
55       This should be at least vaguely related to what was discussed in
56       the end-of-May deliverable.
58   - mid October
59 KS  - Finish implementation of hidden service improvements: have a set
60       of patches that you think work.
61 W   - Finish implementation of directory overhead changes: have a set
62       of patches that you think work.
64   - mid January
65 KS  - Finish testing, debugging, unit testing, etc the hidden service
66       changes. Have it in the development version and in use.
67 W   - Finish testing, debugging, unit testing, etc the directory overhead
68       changes. Have it in the development version and in use.
70 =======================================================================
72 Other things Roger would be excited to see:
74 Nick
75   - Finish buffer stuff in libevent; start using it in Tor.
76   - Tors start believing the contents of NETINFO cells.
77   . Work with Steven and Roger to decide which parts of Paul's project
78     he wants to work on.
79   - respond to Steven's red-team TLS testing (a.k.a, look at a packet
80     dump and compare)
82 Matt
83   - Fit Vidalia in 640x480 again.
84   - When user changes the language in Vidalia, have it change right then.
85   - Vidalia should display/edit PlaintextPorts events/config.
86   . Vidalia's GUI should let you specify an http proxy that it launches
87     for you. Maybe in the general config window next to which Tor it
88     launches for you.
89   - Vidalia should avoid stomping on your custom exit policy lines
90     just because you click on 'save' for a totally different config thing.
91   - How much space do we save in TBB by stripping symbols from Vidalia
92     first? Good idea or crazy idea?
94 ioerror
95   - gmail auto responder so you send us an email and we send you a Tor
96     binary. Probably needs a proposal first.
97   - weather.torproject.org should go live.
98   o Learn from Steven how to build/maintain the Tor Browser Bundle.
99   - Keep advocating new Tor servers and working with orgs like Mozilla
100     to let them like Tor.
101   - Start converting critical wiki pages into real Tor wml pages. E.g.,
102     https://wiki.torproject.org/noreply/TheOnionRouter/VerifyingSignatures
103   - Find out what happened to the buildbot and get it back up:
104     http://tor-buildbot.freehaven.net:8010/
105   - Learn about locking memory pages that have sensitive content. Get
106     that started in Tor.
107   - Translation portal
108     - Vidalia html help files
109     - should we i18nize polipo's error messages too?
110     - Some of our translated wml files are very old -- so old that they
111       are harmful to leave in place. We need some sort of way to notice
112       this and disable them.
114 Steven
115   - Figure out (or give up on) how to run Tor Browser and ordinary
116     Firefox side-by-side.
117   - Enumerate and analyze traces left when running from USB
118   - Write a list of research items Tor would like to see done, for the
119     volunteer page. Pick a few you'd like to work on yourself.
120   - Move proposal 131 or equivalent forward.
121   - Keep bugging us about exploits on the .exit notation.
122   - If relays have 100KB/s but set relaybandwidthrate to 10KB/s, do your
123     interference attacks still work?
124   - Mike's question #3 on https://www.torproject.org/volunteer#Research
125   - Worthwhile shipping TBB with some local html help files that come
126     as bookmarks?
127   - Decide whether TBB should use Torbutton's "lock" feature.
128     http://archives.seul.org/or/cvs/Jun-2008/msg00186.html
130 Andrew
131   - Which bundles include Torbutton? Change the docs/tor-doc-foo pages
132     so they admit that Torbutton is in them too. Change the download
133     page too.
134   - The OS X bundle screenshots are from forever ago -- they don't
135     include Torbutton, they still say it's tor.eff.org, etc.
136   - Should we still be telling you how to use Safari on OS X for Tor,
137     given all the holes that Torbutton-dev solves on Firefox?
139 Karsten
140   o Make a hidden services explanation page with the hidden service
141     diagrams. See img/THS-[1-6].png. These need some text to go along
142     with them though, so people can follow what's going on.
143   - We should consider a single config option TorPrivateNetwork that
144     turns on all the config options for running a private test tor
145     network. having to keep updating all the tools, and the docs,
146     just isn't working.
148 Weasel
149   - Figure out how to make Vidalia and Tor play nicely on Debian, make
150     the necessary modifications, and make some Vidalia debs that pass
151     muster.
152   - Fix bug 393.
153   - Get oftc to switch to Tor dns bulk exitlist. Or tell us why it's
154     not suitable yet.
155   - Take non-Running entries out of the networkstatus consensus.
156   - Move proposal 134 forward.
157   - putting port predictions in state file
158   - if tor hasn't been used in a while it stops fetching consensus
159     documents.  Retain that state over restarts.
161 Roger
162   - Finish tor-doc-bridge.wml
163   . Fix FAQ entry on setting up private Tor network
164   - Review Karsten's hidden service diagrams
165   - Roger should visit Internews DC sometime.
166   - Did we actually apply Steven's dkimproxy patch?
167   - Brainstorm about safe but effective ways for vidalia to
168     auto-update its user's bridges via Tor in the background.
170 Mike:
171   - Roger wants to get an email every time there's a blog change,
172     e.g. a comment. That way spam doesn't go undetected for weeks.
173     - Or, maybe just disable linking from blog comments entirely?
175 =======================================================================
177 Bugs/issues for Tor 0.2.0.x:
178   . we should have an off-by-default way for relays to dump geoip data to
179     a file in their data directory, for measurement purposes.
180     o Basic implementation
181 N   - Include probability-of-selection
182 R d let bridges set relaybandwidthrate as low as 5kb
183 R - bridge communities
184     . spec
185     . deploy
186       - man page entries for Alternate*Authority config options
188 Documentation for Tor 0.2.0.x:
189   - Proposals:
190     . 111: Prioritize local traffic over relayed.
191 R     - Merge into tor-spec.txt.
192     - 113: mark as closed close.
193   o document the "3/4 and 7/8" business in the clients fetching consensus
194     documents timeline.
195 R   - then document the bridge user download timeline.
196   - HOWTO for DNSPort. See tup's wiki page.
197   . Document transport and natdport in a good HOWTO.
198   - Quietly document NT Service options: revise (or create) FAQ entry
200 =======================================================================
202 For 0.2.1.2-alpha:
203 R d bug: if we launch using bridges, and then stop using bridges, we
204     still have our bridges in our entryguards section, and may use them.
205 R d add an event to report geoip summaries to vidalia for bridge relays,
206     so vidalia can say "recent activity (1-8 users) from sa".
207 R - investigate: it looks like if the bridge authority is unreachable,
208     we're not falling back on querying bridges directly?
209 R - if "no running bridges known", an application request should make
210     us retry all our bridges.
211 R - get matt to make vidalia do a getinfo status/bootstrap-phase to
212     get caught up after it connects.
213 R d Setting DirPort when acting as bridge will give false Warnings
215 For 0.2.1.x:
216   - Proposals to do:
217     o 110: avoid infinite-length circuits
218 R   d 128: families of private bridges
219     - 134: handle authority fragmentation.
221   - Proposals to write:
222 R   d Do we want to maintain our own set of entryguards that we use as
223       next hop after the bridge?
224     X Add an 'exit-address' line in the descriptor for servers that exit
225       from something that isn't their published address.
226       [I think tordnsel solved this. -RD]
227     - Proposal to supersede 117 by adding IPv6 support for exits and entries.
228       - Internal code support for ipv6:
229         o Clone ipv6 functions (inet_ntop, inet_pton) where they don't exist.
230         - Many address variables need to become tor_addr_t
231           - addr in connection_t
232           - n_addr in extend_info_t
233         - Teach resolving code how to handle ipv6.
234         . Teach exit policies about ipv6 (consider ipv4/ipv6
235           interaction!)
236         - Generate END_REASON_EXITPOLICY cells and parse them right
237         - Generate new BEGIN cell types and parse them right
238     - 118: Listen on and advertise multiple ports:
239       - Tor should be able to have a pool of outgoing IP addresses that it is
240         able to rotate through. (maybe.  Possible overlap with proposal 118.)
241       - config option to publish what ports you listen on, beyond
242         ORPort/DirPort.  It should support ranges and bit prefixes (?) too.
243       - Need to figure out the right format for routerinfo_t on this.
244     - Fix voting to handle bug 608 case when multiple servers get
245       Named.
246     d Possibly: revise link protocol to allow big circuit IDs,
247       variable-length cells, proposal-110 stuff, and versioned CREATES?
248     o Eliminate use of v2 networkstatus documents in v3 authority
249       decision-making.
250 N   . Draft proposal for GeoIP aggregation (see external constraints *)
251     o Separate Guard flags for "pick this as a new guard" and "keep this
252       as an existing guard".  First investigate if we want this.
253     . Figure out how to make good use of the fallback consensus file. Right
254       now many of the addresses in the fallback consensus will be stale,
255       so it will take dozens of minutes to bootstrap from it. This is a
256       bad first Tor experience. But if we check the fallback consensus
257       file *after* we fail to connect to any authorities, then it may
258       still be valuable as a blocking-resistance step.
259       o Write the proposal.
260       - Patch our tor.spec rpm package so it knows where to put the fallback
261         consensus file.
262     d Something for bug 469, to limit connections per IP.
263     . Put bandwidth weights in the networkstatus? So clients get weight
264       their choices even before they have the descriptors; and so
265       authorities can put in more accurate numbers in the future.
266     d Fetch an updated geoip file from the directory authorities.
268   - Tiny designs to write:
269     . Better estimate of clock skew; has anonymity implications.  Clients
270       should estimate their skew as median of skew from servers over last
271       N seconds, but for servers this is not so easy, since a server does
272       not choose who it connects to.
273     - Do TLS connection rotation more often than "once a week" in the
274       extra-stable case.
275       (One reason not to do it more often is because the old TLS conn
276        probably has a circuit on it, and we don't really want to build up
277        dozens of TCP connections to all the other extra-stable relays.)
278     - If a relay publishes a new descriptor with a significantly lower
279       uptime or with a new IP address, then we should consider its current
280       "running" interval to have ended even if it hadn't yet failed its
281       third reachability test. the interval ended when the new descriptor
282       appeared, and a new interval began then too.
284   - Use less RAM *
285     - Optimize cell pool allocation.
286     d Support (or just always use) jemalloc (if it helps)
287     - mmap more files.
288     - Look into pulling serverdescs off buffers as they arrive.
289   - Use less bandwidth
290     - Use if-modified-since to download consensuses
291   - Handle multi-core cpus better
292   - Use information from NETINFO cells
293     - Don't extend a circuit over a noncanonical connection with
294       mismatched address.
295     - Learn our outgoing IP address from netinfo cells?
296     - Learn skew from netinfo cells?
297   - Testing
298     - Better unit test coverage
299     - Refactor unit tests into multiple files
300     - Verify that write limits to linked connections work.
301   - Use more mid-level and high-level libevent APIs
302     - For dns?
303     - For http?
304     - For buffers?
305   - Tool improvements:
306     - Get IOCP patch into libevent *
308   - Security improvements
309     - make is-consensus-fresh-enough check way tighter.
310     - If we haven't tried downloading a consensus for ages since we're tired,
311       try getting a new one before we use old descriptors for a circuit.
312       Related to bug 401.
314   - Feature removals and deprecations:
315     - Get rid of the v1 directory stuff (making, serving, and caching)
316       - First verify that the caches won't flip out?
317         - If they will, just stop the caches from caching for now
318       - perhaps replace it with a "this is a tor server" stock webpage.
319     - The v2dir flag isn't used for anything anymore, right? If so, dump it.
320     - Even clients run rep_hist_load_mtbf_data(). Does this waste memory?
321       Dump it?
322     - Unless we start using ftime functions, dump them.
323     - can we deprecate 'getinfo network-status'?
324     - can we deprecate the FastFirstHopPK config option?
325     - Can we deprecate controllers that don't use both features?
327 Nice to have for 0.2.1.x:
328   - Proposals to write
329     - steven's plan for replacing check.torproject.org with a built-in
330       answer by tor itself.
332   - Documentation
333 P   - Make documentation realize that location of system configuration file
334       will depend on location of system defaults, and isn't always /etc/torrc.
336   - Small controller features
337     - A status event for when tor decides to stop fetching directory info
338       if the client hasn't clicked recently: then make the onion change too.
339     - Add a status event when new consensus arrives
341   - Windows build
342 P   - Figure out why dll's compiled in mingw don't work right in WinXP.
343 P   - create a "make win32-bundle" for vidalia-privoxy-tor-torbutton bundle
345   - Refactor bad code:
346     - Refactor the HTTP logic so the functions aren't so large.
347     - Refactor buf_read and buf_write to have sensible ways to return
348       error codes after partial writes
349     - Router_choose_random_node() has a big pile of args. make it "flags".
350     - Streamline how we pick entry nodes: Make choose_random_entry() have
351       less magic and less control logic.
352     - Don't call time(NULL) so much; instead have a static time_t field
353       that gets updated only a handful of times per second.
354     - Move all status info out of routerinfo into local_routerstatus.  Make
355       "who can change what" in local_routerstatus explicit.  Make
356       local_routerstatus (or equivalent) subsume all places to go for "what
357       router is this?"
358     - deprecate router_digest_is_trusted_dir() in favor of
359       router_get_trusteddirserver_by_digest()
361   - Make Tor able to chroot itself
362     o allow it to load an entire config file from control interface
363     - document LOADCONF
364     - log rotation (and FD passing) via control interface
365     - chroot yourself, including inhibit trying to read config file
366       and reopen logs, unless they are under datadir.
368   - Should be trivial:
369     - Base relative control socket paths (and other stuff in torrc) on datadir.
370     - Tor logs the libevent version on startup, for debugging purposes.
371       This is great. But it does this before configuring the logs, so
372       it only goes to stdout and is then lost.
373     - Make TrackHostExits expire TrackHostExitsExpire seconds after their
374       *last* use, not their *first* use.
375     - enforce a lower limit on MaxCircuitDirtiness and CircuitBuildTimeout.
376     - Make 'safelogging' extend to info-level logs too.
377     - don't do dns hijacking tests if we're reject *:* exit policy?
378       (deferred until 0.1.1.x is less common)
379     - More consistent error checking in router_parse_entry_from_string().
380       I can say "banana" as my bandwidthcapacity, and it won't even squeak.
382   - Interface for letting SOAT modify flags that authorities assign.
383     (How to keep the authority from clobbering them afterwards?
385 Later, unless people want to implement them now:
386   - Actually use SSL_shutdown to close our TLS connections.
387   - Include "v" line in networkstatus getinfo values.
388     [Nick: bridge authorities output a networkstatus that is missing
389      version numbers. This is inconvenient if we want to make sure
390      bridgedb gives out bridges with certain characteristics. -RD]
391     [Okay. Is this a separate item, or is it the same issue as the lack of
392      a "v" line in response to the controller GETINFO command? -NM]
393   - Let tor dir mirrors proxy connections to the tor download site, so
394     if you know a bridge you can fetch the tor software.
395   - when somebody uses the controlport as an http proxy, give them
396     a "tor isn't an http proxy" error too like we do for the socks port.
397   - MAYBE kill stalled circuits rather than stalled connections.  This is
398     possible thanks to cell queues, but we need to consider the anonymity
399     implications.
400   - Make resolves no longer use edge_connection_t unless they are actually
401     _on_ a socks connection: have edge_connection_t and (say)
402     dns_request_t both extend an edge_stream_t, and have p_streams and
403     n_streams both be linked lists of edge_stream_t.
404   - Generate torrc.{complete|sample}.in, tor.1.in, the HTML manual, and the
405     online config documentation from a single source.
406   - It would be potentially helpful to respond to https requests on
407     the OR port by acting like an HTTPS server.
408   - Make the timestamp granularity on logs configurable, with default
409     of "1 second".  This might make some kinds of after-the-fact attack harder.
411 Can anybody remember why we wanted to do this and/or what it means?
412   - config option __ControllerLimit that hangs up if there are a limit
413     of controller connections already.
414     [This was mwenge's idea. The idea is that a Tor controller can
415      "fill" Tor's controller slot quota, so jerks can't do cross-protocol
416      attacks like the http form attack. -RD]
417   - Bridge issues
418     . Ask all directory questions to bridge via BEGIN_DIR.
419     - use the bridges for dir fetches even when our dirport is open.
420     - drop 'authority' queries if they're to our own identity key; accept
421       them otherwise.
422       - give extend_info_t a router_purpose again
426 If somebody wants to do this in some version, they should:
427   - Create packages for Nokia 800, requested by Chris Soghoian
428   - More work on AvoidDiskWrites
429   - Make DNSPort support TCP DNS.
432 * * * * Roger, please sort these: * * * *
434   - bridge communities with local bridge authorities:
435     - clients who have a password configured decide to ask their bridge
436       authority for a networkstatus
437     - be able to have bridges that aren't in your torrc. save them in
438       state file, etc.
439   - Consider if we can solve: the Tor client doesn't know what flags
440     its bridge has (since it only gets the descriptor), so it can't
441     make decisions based on Fast or Stable.
442   - Some mechanism for specifying that we want to stop using a cached
443     bridge.
445 =======================================================================
447 Future versions:
449   - Protocol
450     - Our current approach to block attempts to use Tor as a single-hop proxy
451       is pretty lame; we should get a better one.
452     - Allow small cells and large cells on the same network?
453     - Cell buffering and resending. This will allow us to handle broken
454       circuits as long as the endpoints don't break, plus will allow
455       connection (tls session key) rotation.
456     - Implement Morphmix, so we can compare its behavior, complexity,
457       etc.  But see paper breaking morphmix.
458     - Other transport. HTTP, udp, rdp, airhook, etc. May have to do our own
459       link crypto, unless we can bully DTLS into it.
460     - Need a relay teardown cell, separate from one-way ends.
461       (Pending a user who needs this)
462     - Handle half-open connections: right now we don't support all TCP
463       streams, at least according to the protocol. But we handle all that
464       we've seen in the wild.
465       (Pending a user who needs this)
467   - Directory system
468     - BEGIN_DIR items
469       - handle connect-dir streams that don't have a chosen_exit_name set.
470     - Have a "Faster" status flag that means it. Fast2, Fast4, Fast8?
471     - Add an option (related to AvoidDiskWrites) to disable directory
472       caching.  (Is this actually a good idea??)
473     X Add d64 and fp64 along-side d and fp so people can paste status
474       entries into a url. since + is a valid base64 char, only allow one
475       at a time. Consider adding to controller as well.
476       [abandoned for lack of demand]
477     - Some back-out mechanism for auto-approval on authorities
478       - a way of rolling back approvals to before a timestamp
479         - Consider minion-like fingerprint file/log combination.
480     X Have new people be in limbo and need to demonstrate usefulness
481       before we approve them.
483   - Hidden services:
484     d Standby/hotswap/redundant hidden services: needs a proposal.
485     - you can insert a hidserv descriptor via the controller.
486     - auth mechanisms to let hidden service midpoint and responder filter
487       connection requests: proposal 121.
488     - Let each hidden service (or other thing) specify its own
489       OutboundBindAddress?
491   - Server operation
492     - If the server is spewing complaints about raising your ulimit -n,
493       we should add a note about this to the server descriptor so other
494       people can notice too.
495     - When we hit a funny error from a dir request (eg 403 forbidden),
496       but tor is working and happy otherwise, and we haven't seen many
497       such errors recently, then don't warn about it.
499   - Controller
500     - Implement missing status events and accompanying getinfos
501       - DIR_REACHABLE
502       - BAD_DIR_RESPONSE (Unexpected directory response; maybe we're behind
503         a firewall.)
504       - BAD_PROXY (Bad http or https proxy)
505       - UNRECOGNIZED_ROUTER (a nickname we asked for is unavailable)
506       - Status events related to hibernation
507       - something about failing to parse our address?
508         from resolve_my_address() in config.c
509       - sketchy OS, sketchy threading
510       - too many onions queued: threading problems or slow CPU?
511     - Implement missing status event fields:
512       - TIMEOUT on CHECKING_REACHABILITY
513     - GETINFO status/client, status/server, status/general: There should be
514       some way to learn which status events are currently "in effect."
515       We should specify which these are, what format they appear in, and so
516       on.
517     - More information in events:
518       - Include bandwidth breakdown by conn->type in BW events.
519       - Change circuit status events to give more details, like purpose,
520         whether they're internal, when they become dirty, when they become
521         too dirty for further circuits, etc.
522       - Change stream status events analogously.
523     - Expose more information via getinfo:
524       - import and export rendezvous descriptors
525       - Review all static fields for additional candidates
526     - Allow EXTENDCIRCUIT to unknown server.
527       - We need some way to adjust server status, and to tell tor not to
528         download directories/network-status, and a way to force a download.
529       - Make everything work with hidden services
531   - Performance/resources
532     - per-conn write buckets
533     - separate config options for read vs write limiting
534       (It's hard to support read > write, since we need better
535        congestion control to avoid overfull buffers there.  So,
536        defer the whole thing.)
537     - Rate limit exit connections to a given destination -- this helps
538       us play nice with websites when Tor users want to crawl them; it
539       also introduces DoS opportunities.
540     - Consider truncating rather than destroying failed circuits,
541       in order to save the effort of restarting.  There are security
542       issues here that need thinking, though.
543     - Handle full buffers without totally borking
544     - Rate-limit OR and directory connections overall and per-IP and
545       maybe per subnet.
547   - Misc
548     - Hold-open-until-flushed now works by accident; it should work by
549       design.
550     - Display the reasons in 'destroy' and 'truncated' cells under
551       some circumstances?
552     - Make router_is_general_exit() a bit smarter once we're sure what
553       it's for.
554     - Automatically determine what ports are reachable and start using
555       those, if circuits aren't working and it's a pattern we
556       recognize ("port 443 worked once and port 9001 keeps not
557       working").
559   - Security
560     - some better fix for bug #516?
561     - Directory guards
562     - Mini-SoaT:
563       - Servers might check certs for known-good ssl websites, and if
564         they come back self-signed, declare themselves to be
565         non-exits.  Similar to how we test for broken/evil dns now.
566       - Authorities should try using exits for http to connect to some
567         URLS (specified in a configuration file, so as not to make the
568         List Of Things Not To Censor completely obvious) and ask them
569         for results.  Exits that don't give good answers should have
570         the BadExit flag set.
571       - Alternatively, authorities should be able to import opinions
572         from Snakes on a Tor.
573     - Bind to random port when making outgoing connections to Tor servers,
574       to reduce remote sniping attacks.
575     - Audit everything to make sure rend and intro points are just as
576       likely to be us as not.
577     - Do something to prevent spurious EXTEND cells from making
578       middleman nodes connect all over.  Rate-limit failed
579       connections, perhaps?
580     - DoS protection: TLS puzzles, public key ops, bandwidth exhaustion.
582   - Needs thinking
583     - Now that we're avoiding exits when picking non-exit positions,
584       we need to consider how to pick nodes for internal circuits. If
585       we avoid exits for all positions, we skew the load balancing. If
586       we accept exits for all positions, we leak whether it's an
587       internal circuit at every step. If we accept exits only at the
588       last hop, we reintroduce Lasse's attacks from the Oakland paper.
590   - Windows server usability
591     - Solve the ENOBUFS problem.
592       - make tor's use of openssl operate on buffers rather than sockets,
593         so we can make use of libevent's buffer paradigm once it has one.
594       - make tor's use of libevent tolerate either the socket or the
595         buffer paradigm; includes unifying the functions in connect.c.
596     - We need a getrlimit equivalent on Windows so we can reserve some
597       file descriptors for saving files, etc. Otherwise we'll trigger
598       asserts when we're out of file descriptors and crash.
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     - Refactor tor man page to divide generally useful options from
607       less useful ones?
608     - Add a doxygen style checker to make check-spaces so nick doesn't drift
609        too far from arma's undocumented styleguide.  Also, document that
610        styleguide in HACKING.  (See r9634 for example.)
611        - exactly one space at beginning and at end of comments, except i
612          guess when there's line-length pressure.
613        - if we refer to a function name, put a () after it.
614        - only write <b>foo</b> when foo is an argument to this function.
615        - doxygen comments must always end in some form of punctuation.
616        - capitalize the first sentence in the doxygen comment, except
617          when you shouldn't.
618        - avoid spelling errors and incorrect comments. ;)
620   - Packaging
621     - The Debian package now uses --verify-config when (re)starting,
622       to distinguish configuration errors from other errors. Perhaps
623       the RPM and other startup scripts should too?
624     - add a "default.action" file to the tor/vidalia bundle so we can
625       fix the https thing in the default configuration:
626       http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#PrivoxyWeirdSSLPort
629 =======================================================================
631 Documentation, non-version-specific.
632   - Specs
633     - Mark up spec; note unclear points about servers
634 NR  - write a spec appendix for 'being nice with tor'
635     - Specify the keys and key rotation schedules and stuff
636     . Finish path-spec.txt
637   - Mention controller libs someplace.
638   - Remove need for HACKING file.
639   - document http://wiki.noreply.org/noreply/TheOnionRouter/TransparentProxy on freebsd and osx
640 P - figure out why x86_64 won't build rpms from tor.spec
641 P - figure out rpm spec files for bundles of vidalia-tor-polipo
642 P - figure out polipo install scripts for bundles of vidalia-tor-polipo on osx, win32
643   - figure out selinux policy for tor
644 P - change packaging system to more automated and specific for each
645      platform, suggested by Paul Wouter
646 P - Setup repos for redhat and suse rpms & start signing the rpms the
647     way package management apps prefer
649 Website:
650 J . tor-in-the-media page
651 P  - Figure out licenses for website material.
652     (Phobos reccomends the Open Publication License with Option A at
653     http://opencontent.org/openpub/)
654 P  - put the logo on the website, in source form, so people can put it on
655     stickers directly, etc.
656 P  - put the source image for the stickers on the website, so people can
657     print their own
658 P - figure out a license for the logos and docs we publish (trademark
659 figures into this)
660     (Phobos reccomends the Open Publication License with Option A at
661     http://opencontent.org/openpub/)
662 P  - ask Jan/Jens to be the translation coordinator? add to volunteer page.
663 I - add a page for localizing all tor's components.
664   - It would be neat if we had a single place that described _all_ the
665     tor-related tools you can use, and what they give you, and how well they
666     work.  Right now, we don't give a lot of guidance wrt
667     torbutton/foxproxy/privoxy/polipo in any consistent place.
668 P - create a 'blog badge' for tor fans to link to and feature on their
669     blogs. A sample is at http://interloper.org/tmp/tor/tor-button.png
670   - More prominently, we should have a recommended apps list.
671     - recommend pidgin (gaim is renamed)
672     - unrecommend IE because of ftp:// bug.
673   - Addenda to tor-design
674     - we should add a preamble to tor-design saying it's out of date.
675     - we should add an appendix or errata on what's changed.
677   - Tor mirrors
678     - make a mailing list with the mirror operators
679     o make an automated tool to check /project/trace/ at mirrors to
680       learn which ones are lagging behind.
681     - auto (or manually) cull the mirrors that are broken; and
682       contact their operator?
683     - a set of instructions for mirror operators to make their apaches
684       serve our charsets correctly, and bonus points for language
685       negotiation.
686     - figure out how to load-balance the downloads across mirrors?
687     - ponder how to get users to learn that they should google for
688       "tor mirrors" if the main site is blocked.
689     - find a mirror volunteer to coordinate all of this