r17309@aud-055: nickm | 2008-07-23 16:05:43 +0200
[tor.git] / ReleaseNotes
blob52e022b86f334123c0499fe17e47e9396bfaa188
2 This document summarizes new features and bugfixes in each stable release
3 of Tor. If you want to see more detailed descriptions of the changes in
4 each development snapshot, see the ChangeLog file.
6 Changes in version 0.2.0.30 - 2008-07-15
7   This new stable release switches to a more efficient directory
8   distribution design, adds features to make connections to the Tor
9   network harder to block, allows Tor to act as a DNS proxy, adds separate
10   rate limiting for relayed traffic to make it easier for clients to
11   become relays, fix a variety of potential anonymity problems, and
12   includes the usual huge pile of other features and bug fixes.
14   o New v3 directory design:
15     - Tor now uses a new way to learn about and distribute information
16       about the network: the directory authorities vote on a common
17       network status document rather than each publishing their own
18       opinion. Now clients and caches download only one networkstatus
19       document to bootstrap, rather than downloading one for each
20       authority. Clients only download router descriptors listed in
21       the consensus. Implements proposal 101; see doc/spec/dir-spec.txt
22       for details.
23     - Set up moria1, tor26, and dizum as v3 directory authorities
24       in addition to being v2 authorities. Also add three new ones:
25       ides (run by Mike Perry), gabelmoo (run by Karsten Loesing), and
26       dannenberg (run by CCC).
27     - Switch to multi-level keys for directory authorities: now their
28       long-term identity key can be kept offline, and they periodically
29       generate a new signing key. Clients fetch the "key certificates"
30       to keep up to date on the right keys. Add a standalone tool
31       "tor-gencert" to generate key certificates. Implements proposal 103.
32     - Add a new V3AuthUseLegacyKey config option to make it easier for
33       v3 authorities to change their identity keys if another bug like
34       Debian's OpenSSL RNG flaw appears.
35     - Authorities and caches fetch the v2 networkstatus documents
36       less often, now that v3 is recommended.
38   o Make Tor connections stand out less on the wire:
39     - Use an improved TLS handshake designed by Steven Murdoch in proposal
40       124, as revised in proposal 130. The new handshake is meant to
41       be harder for censors to fingerprint, and it adds the ability
42       to detect certain kinds of man-in-the-middle traffic analysis
43       attacks. The new handshake format includes version negotiation for
44       OR connections as described in proposal 105, which will allow us
45       to improve Tor's link protocol more safely in the future.
46     - Enable encrypted directory connections by default for non-relays,
47       so censor tools that block Tor directory connections based on their
48       plaintext patterns will no longer work. This means Tor works in
49       certain censored countries by default again.
50     - Stop including recognizeable strings in the commonname part of
51       Tor's x509 certificates.
53   o Implement bridge relays:
54     - Bridge relays (or "bridges" for short) are Tor relays that aren't
55       listed in the main Tor directory. Since there is no complete public
56       list of them, even an ISP that is filtering connections to all the
57       known Tor relays probably won't be able to block all the bridges.
58       See doc/design-paper/blocking.pdf and proposal 125 for details.
59     - New config option BridgeRelay that specifies you want to be a
60       bridge relay rather than a normal relay. When BridgeRelay is set
61       to 1, then a) you cache dir info even if your DirPort ins't on,
62       and b) the default for PublishServerDescriptor is now "bridge"
63       rather than "v2,v3".
64     - New config option "UseBridges 1" for clients that want to use bridge
65       relays instead of ordinary entry guards. Clients then specify
66       bridge relays by adding "Bridge" lines to their config file. Users
67       can learn about a bridge relay either manually through word of
68       mouth, or by one of our rate-limited mechanisms for giving out
69       bridge addresses without letting an attacker easily enumerate them
70       all. See https://www.torproject.org/bridges for details.
71     - Bridge relays behave like clients with respect to time intervals
72       for downloading new v3 consensus documents -- otherwise they
73       stand out. Bridge users now wait until the end of the interval,
74       so their bridge relay will be sure to have a new consensus document.
76   o Implement bridge directory authorities:
77     - Bridge authorities are like normal directory authorities, except
78       they don't serve a list of known bridges. Therefore users that know
79       a bridge's fingerprint can fetch a relay descriptor for that bridge,
80       including fetching updates e.g. if the bridge changes IP address,
81       yet an attacker can't just fetch a list of all the bridges.
82     - Set up Tonga as the default bridge directory authority.
83     - Bridge authorities refuse to serve bridge descriptors or other
84       bridge information over unencrypted connections (that is, when
85       responding to direct DirPort requests rather than begin_dir cells.)
86     - Bridge directory authorities do reachability testing on the
87       bridges they know. They provide router status summaries to the
88       controller via "getinfo ns/purpose/bridge", and also dump summaries
89       to a file periodically, so we can keep internal stats about which
90       bridges are functioning.
91     - If bridge users set the UpdateBridgesFromAuthority config option,
92       but the digest they ask for is a 404 on the bridge authority,
93       they fall back to contacting the bridge directly.
94     - Bridges always use begin_dir to publish their server descriptor to
95       the bridge authority using an anonymous encrypted tunnel.
96     - Early work on a "bridge community" design: if bridge authorities set
97       the BridgePassword config option, they will serve a snapshot of
98       known bridge routerstatuses from their DirPort to anybody who
99       knows that password. Unset by default.
100     - Tor now includes an IP-to-country GeoIP file, so bridge relays can
101       report sanitized aggregated summaries in their extra-info documents
102       privately to the bridge authority, listing which countries are
103       able to reach them. We hope this mechanism will let us learn when
104       certain countries start trying to block bridges.
105     - Bridge authorities write bridge descriptors to disk, so they can
106       reload them after a reboot. They can also export the descriptors
107       to other programs, so we can distribute them to blocked users via
108       the BridgeDB interface, e.g. via https://bridges.torproject.org/
109       and bridges@torproject.org.
111   o Tor can be a DNS proxy:
112     - The new client-side DNS proxy feature replaces the need for
113       dns-proxy-tor: Just set "DNSPort 9999", and Tor will now listen
114       for DNS requests on port 9999, use the Tor network to resolve them
115       anonymously, and send the reply back like a regular DNS server.
116       The code still only implements a subset of DNS.
117     - Add a new AutomapHostsOnResolve option: when it is enabled, any
118       resolve request for hosts matching a given pattern causes Tor to
119       generate an internal virtual address mapping for that host. This
120       allows DNSPort to work sensibly with hidden service users. By
121       default, .exit and .onion addresses are remapped; the list of
122       patterns can be reconfigured with AutomapHostsSuffixes.
123     - Add an "-F" option to tor-resolve to force a resolve for a .onion
124       address. Thanks to the AutomapHostsOnResolve option, this is no
125       longer a completely silly thing to do.
127   o Major features (relay usability):
128     - New config options RelayBandwidthRate and RelayBandwidthBurst:
129       a separate set of token buckets for relayed traffic. Right now
130       relayed traffic is defined as answers to directory requests, and
131       OR connections that don't have any local circuits on them. See
132       proposal 111 for details.
133     - Create listener connections before we setuid to the configured
134       User and Group. Now non-Windows users can choose port values
135       under 1024, start Tor as root, and have Tor bind those ports
136       before it changes to another UID. (Windows users could already
137       pick these ports.)
138     - Added a new ConstrainedSockets config option to set SO_SNDBUF and
139       SO_RCVBUF on TCP sockets. Hopefully useful for Tor servers running
140       on "vserver" accounts. Patch from coderman.
142   o Major features (directory authorities):
143     - Directory authorities track weighted fractional uptime and weighted
144       mean-time-between failures for relays. WFU is suitable for deciding
145       whether a node is "usually up", while MTBF is suitable for deciding
146       whether a node is "likely to stay up." We need both, because
147       "usually up" is a good requirement for guards, while "likely to
148       stay up" is a good requirement for long-lived connections.
149     - Directory authorities use a new formula for selecting which relays
150       to advertise as Guards: they must be in the top 7/8 in terms of
151       how long we have known about them, and above the median of those
152       nodes in terms of weighted fractional uptime.
153     - Directory authorities use a new formula for selecting which relays
154       to advertise as Stable: when we have 4 or more days of data, use
155       median measured MTBF rather than median declared uptime. Implements
156       proposal 108.
157     - Directory authorities accept and serve "extra info" documents for
158       routers. Routers now publish their bandwidth-history lines in the
159       extra-info docs rather than the main descriptor. This step saves
160       60% (!) on compressed router descriptor downloads. Servers upload
161       extra-info docs to any authority that accepts them; directory
162       authorities now allow multiple router descriptors and/or extra
163       info documents to be uploaded in a single go. Authorities, and
164       caches that have been configured to download extra-info documents,
165       download them as needed. Implements proposal 104.
166     - Authorities now list relays who have the same nickname as
167       a different named relay, but list them with a new flag:
168       "Unnamed". Now we can make use of relays that happen to pick the
169       same nickname as a server that registered two years ago and then
170       disappeared. Implements proposal 122.
171     - Store routers in a file called cached-descriptors instead of in
172       cached-routers. Initialize cached-descriptors from cached-routers
173       if the old format is around. The new format allows us to store
174       annotations along with descriptors, to record the time we received
175       each descriptor, its source, and its purpose: currently one of
176       general, controller, or bridge.
178   o Major features (other):
179     - New config options WarnPlaintextPorts and RejectPlaintextPorts so
180       Tor can warn and/or refuse connections to ports commonly used with
181       vulnerable-plaintext protocols. Currently we warn on ports 23,
182       109, 110, and 143, but we don't reject any. Based on proposal 129
183       by Kevin Bauer and Damon McCoy.
184     - Integrate Karsten Loesing's Google Summer of Code project to publish
185       hidden service descriptors on a set of redundant relays that are a
186       function of the hidden service address. Now we don't have to rely
187       on three central hidden service authorities for publishing and
188       fetching every hidden service descriptor. Implements proposal 114.
189     - Allow tunnelled directory connections to ask for an encrypted
190       "begin_dir" connection or an anonymized "uses a full Tor circuit"
191       connection independently. Now we can make anonymized begin_dir
192       connections for (e.g.) more secure hidden service posting and
193       fetching.
195   o Major bugfixes (crashes and assert failures):
196     - Stop imposing an arbitrary maximum on the number of file descriptors
197       used for busy servers. Bug reported by Olaf Selke; patch from
198       Sebastian Hahn.
199     - Avoid possible failures when generating a directory with routers
200       with over-long versions strings, or too many flags set.
201     - Fix a rare assert error when we're closing one of our threads:
202       use a mutex to protect the list of logs, so we never write to the
203       list as it's being freed. Fixes the very rare bug 575, which is
204       kind of the revenge of bug 222.
205     - Avoid segfault in the case where a badly behaved v2 versioning
206       directory sends a signed networkstatus with missing client-versions.
207     - When we hit an EOF on a log (probably because we're shutting down),
208       don't try to remove the log from the list: just mark it as
209       unusable. (Bulletproofs against bug 222.)
211   o Major bugfixes (code security fixes):
212     - Detect size overflow in zlib code. Reported by Justin Ferguson and
213       Dan Kaminsky.
214     - Rewrite directory tokenization code to never run off the end of
215       a string. Fixes bug 455. Patch from croup.
216     - Be more paranoid about overwriting sensitive memory on free(),
217       as a defensive programming tactic to ensure forward secrecy.
219   o Major bugfixes (anonymity fixes):
220     - Reject requests for reverse-dns lookup of names that are in
221       a private address space. Patch from lodger.
222     - Never report that we've used more bandwidth than we're willing to
223       relay: it leaks how much non-relay traffic we're using. Resolves
224       bug 516.
225     - As a client, do not believe any server that tells us that an
226       address maps to an internal address space.
227     - Warn about unsafe ControlPort configurations.
228     - Directory authorities now call routers Fast if their bandwidth is
229       at least 100KB/s, and consider their bandwidth adequate to be a
230       Guard if it is at least 250KB/s, no matter the medians. This fix
231       complements proposal 107.
232     - Directory authorities now never mark more than 2 servers per IP as
233       Valid and Running (or 5 on addresses shared by authorities).
234       Implements proposal 109, by Kevin Bauer and Damon McCoy.
235     - If we're a relay, avoid picking ourselves as an introduction point,
236       a rendezvous point, or as the final hop for internal circuits. Bug
237       reported by taranis and lodger.
238     - Exit relays that are used as a client can now reach themselves
239       using the .exit notation, rather than just launching an infinite
240       pile of circuits. Fixes bug 641. Reported by Sebastian Hahn.
241     - Fix a bug where, when we were choosing the 'end stream reason' to
242       put in our relay end cell that we send to the exit relay, Tor
243       clients on Windows were sometimes sending the wrong 'reason'. The
244       anonymity problem is that exit relays may be able to guess whether
245       the client is running Windows, thus helping partition the anonymity
246       set. Down the road we should stop sending reasons to exit relays,
247       or otherwise prevent future versions of this bug.
248     - Only update guard status (usable / not usable) once we have
249       enough directory information. This was causing us to discard all our
250       guards on startup if we hadn't been running for a few weeks. Fixes
251       bug 448.
252     - When our directory information has been expired for a while, stop
253       being willing to build circuits using it. Fixes bug 401.
255   o Major bugfixes (peace of mind for relay operators)
256     - Non-exit relays no longer answer "resolve" relay cells, so they
257       can't be induced to do arbitrary DNS requests. (Tor clients already
258       avoid using non-exit relays for resolve cells, but now servers
259       enforce this too.) Fixes bug 619. Patch from lodger.
260     - When we setconf ClientOnly to 1, close any current OR and Dir
261       listeners. Reported by mwenge.
263   o Major bugfixes (other):
264     - If we only ever used Tor for hidden service lookups or posts, we
265       would stop building circuits and start refusing connections after
266       24 hours, since we falsely believed that Tor was dormant. Reported
267       by nwf.
268     - Add a new __HashedControlSessionPassword option for controllers
269       to use for one-off session password hashes that shouldn't get
270       saved to disk by SAVECONF --- Vidalia users were accumulating a
271       pile of HashedControlPassword lines in their torrc files, one for
272       each time they had restarted Tor and then clicked Save. Make Tor
273       automatically convert "HashedControlPassword" to this new option but
274       only when it's given on the command line. Partial fix for bug 586.
275     - Patch from "Andrew S. Lists" to catch when we contact a directory
276       mirror at IP address X and he says we look like we're coming from
277       IP address X. Otherwise this would screw up our address detection.
278     - Reject uploaded descriptors and extrainfo documents if they're
279       huge. Otherwise we'll cache them all over the network and it'll
280       clog everything up. Suggested by Aljosha Judmayer.
281     - When a hidden service was trying to establish an introduction point,
282       and Tor *did* manage to reuse one of the preemptively built
283       circuits, it didn't correctly remember which one it used,
284       so it asked for another one soon after, until there were no
285       more preemptive circuits, at which point it launched one from
286       scratch. Bugfix on 0.0.9.x.
288   o Rate limiting and load balancing improvements:
289     - When we add data to a write buffer in response to the data on that
290       write buffer getting low because of a flush, do not consider the
291       newly added data as a candidate for immediate flushing, but rather
292       make it wait until the next round of writing. Otherwise, we flush
293       and refill recursively, and a single greedy TLS connection can
294       eat all of our bandwidth.
295     - When counting the number of bytes written on a TLS connection,
296       look at the BIO actually used for writing to the network, not
297       at the BIO used (sometimes) to buffer data for the network.
298       Looking at different BIOs could result in write counts on the
299       order of ULONG_MAX. Fixes bug 614.
300     - If we change our MaxAdvertisedBandwidth and then reload torrc,
301       Tor won't realize it should publish a new relay descriptor. Fixes
302       bug 688, reported by mfr.
303     - Avoid using too little bandwidth when our clock skips a few seconds.
304     - Choose which bridge to use proportional to its advertised bandwidth,
305       rather than uniformly at random. This should speed up Tor for
306       bridge users. Also do this for people who set StrictEntryNodes.
308   o Bootstrapping faster and building circuits more intelligently:
309     - Fix bug 660 that was preventing us from knowing that we should
310       preemptively build circuits to handle expected directory requests.
311     - When we're checking if we have enough dir info for each relay
312       to begin establishing circuits, make sure that we actually have
313       the descriptor listed in the consensus, not just any descriptor.
314     - Correctly notify one-hop connections when a circuit build has
315       failed. Possible fix for bug 669. Found by lodger.
316     - Clients now hold circuitless TLS connections open for 1.5 times
317       MaxCircuitDirtiness (15 minutes), since it is likely that they'll
318       rebuild a new circuit over them within that timeframe. Previously,
319       they held them open only for KeepalivePeriod (5 minutes).
321   o Performance improvements (memory):
322     - Add OpenBSD malloc code from "phk" as an optional malloc
323       replacement on Linux: some glibc libraries do very poorly with
324       Tor's memory allocation patterns. Pass --enable-openbsd-malloc to
325       ./configure to get the replacement malloc code.
326     - Switch our old ring buffer implementation for one more like that
327       used by free Unix kernels. The wasted space in a buffer with 1mb
328       of data will now be more like 8k than 1mb. The new implementation
329       also avoids realloc();realloc(); patterns that can contribute to
330       memory fragmentation.
331     - Change the way that Tor buffers data that it is waiting to write.
332       Instead of queueing data cells in an enormous ring buffer for each
333       client->OR or OR->OR connection, we now queue cells on a separate
334       queue for each circuit. This lets us use less slack memory, and
335       will eventually let us be smarter about prioritizing different kinds
336       of traffic.
337     - Reference-count and share copies of address policy entries; only 5%
338       of them were actually distinct.
339     - Tune parameters for cell pool allocation to minimize amount of
340       RAM overhead used.
341     - Keep unused 4k and 16k buffers on free lists, rather than wasting 8k
342       for every single inactive connection_t. Free items from the
343       4k/16k-buffer free lists when they haven't been used for a while.
344     - Make memory debugging information describe more about history
345       of cell allocation, so we can help reduce our memory use.
346     - Be even more aggressive about releasing RAM from small
347       empty buffers. Thanks to our free-list code, this shouldn't be too
348       performance-intensive.
349     - Log malloc statistics from mallinfo() on platforms where it exists.
350     - Use memory pools to allocate cells with better speed and memory
351       efficiency, especially on platforms where malloc() is inefficient.
352     - Add a --with-tcmalloc option to the configure script to link
353       against tcmalloc (if present). Does not yet search for non-system
354       include paths.
356   o Performance improvements (socket management):
357     - Count the number of open sockets separately from the number of
358       active connection_t objects. This will let us avoid underusing
359       our allocated connection limit.
360     - We no longer use socket pairs to link an edge connection to an
361       anonymous directory connection or a DirPort test connection.
362       Instead, we track the link internally and transfer the data
363       in-process. This saves two sockets per "linked" connection (at the
364       client and at the server), and avoids the nasty Windows socketpair()
365       workaround.
366     - We were leaking a file descriptor if Tor started with a zero-length
367       cached-descriptors file. Patch by "freddy77".
369   o Performance improvements (CPU use):
370     - Never walk through the list of logs if we know that no log target
371       is interested in a given message.
372     - Call routerlist_remove_old_routers() much less often. This should
373       speed startup, especially on directory caches.
374     - Base64 decoding was actually showing up on our profile when parsing
375       the initial descriptor file; switch to an in-process all-at-once
376       implementation that's about 3.5x times faster than calling out to
377       OpenSSL.
378     - Use a slightly simpler string hashing algorithm (copying Python's
379       instead of Java's) and optimize our digest hashing algorithm to take
380       advantage of 64-bit platforms and to remove some possibly-costly
381       voodoo.
382     - When implementing AES counter mode, update only the portions of the
383       counter buffer that need to change, and don't keep separate
384       network-order and host-order counters on big-endian hosts (where
385       they are the same).
386     - Add an in-place version of aes_crypt() so that we can avoid doing a
387       needless memcpy() call on each cell payload.
388     - Use Critical Sections rather than Mutexes for synchronizing threads
389       on win32; Mutexes are heavier-weight, and designed for synchronizing
390       between processes.
392   o Performance improvements (bandwidth use):
393     - Don't try to launch new descriptor downloads quite so often when we
394       already have enough directory information to build circuits.
395     - Version 1 directories are no longer generated in full. Instead,
396       authorities generate and serve "stub" v1 directories that list
397       no servers. This will stop Tor versions 0.1.0.x and earlier from
398       working, but (for security reasons) nobody should be running those
399       versions anyway.
400     - Avoid going directly to the directory authorities even if you're a
401       relay, if you haven't found yourself reachable yet or if you've
402       decided not to advertise your dirport yet. Addresses bug 556.
403     - If we've gone 12 hours since our last bandwidth check, and we
404       estimate we have less than 50KB bandwidth capacity but we could
405       handle more, do another bandwidth test.
406     - Support "If-Modified-Since" when answering HTTP requests for
407       directories, running-routers documents, and v2 and v3 networkstatus
408       documents. (There's no need to support it for router descriptors,
409       since those are downloaded by descriptor digest.)
410     - Stop fetching directory info so aggressively if your DirPort is
411       on but your ORPort is off; stop fetching v2 dir info entirely.
412       You can override these choices with the new FetchDirInfoEarly
413       config option.
415   o Changed config option behavior (features):
416     - Configuration files now accept C-style strings as values. This
417       helps encode characters not allowed in the current configuration
418       file format, such as newline or #. Addresses bug 557.
419     - Add hidden services and DNSPorts to the list of things that make
420       Tor accept that it has running ports. Change starting Tor with no
421       ports from a fatal error to a warning; we might change it back if
422       this turns out to confuse anybody. Fixes bug 579.
423     - Make PublishServerDescriptor default to 1, so the default doesn't
424       have to change as we invent new directory protocol versions.
425     - Allow people to say PreferTunnelledDirConns rather than
426       PreferTunneledDirConns, for those alternate-spellers out there.
427     - Raise the default BandwidthRate/BandwidthBurst to 5MB/10MB, to
428       accommodate the growing number of servers that use the default
429       and are reaching it.
430     - Make it possible to enable HashedControlPassword and
431       CookieAuthentication at the same time.
432     - When a TrackHostExits-chosen exit fails too many times in a row,
433       stop using it. Fixes bug 437.
435   o Changed config option behavior (bugfixes):
436     - Do not read the configuration file when we've only been told to
437       generate a password hash. Fixes bug 643. Bugfix on 0.0.9pre5. Fix
438       based on patch from Sebastian Hahn.
439     - Actually validate the options passed to AuthDirReject,
440       AuthDirInvalid, AuthDirBadDir, and AuthDirBadExit.
441     - Make "ClientOnly 1" config option disable directory ports too.
442     - Don't stop fetching descriptors when FetchUselessDescriptors is
443       set, even if we stop asking for circuits. Bug reported by tup
444       and ioerror.
445     - Servers used to decline to publish their DirPort if their
446       BandwidthRate or MaxAdvertisedBandwidth were below a threshold. Now
447       they look only at BandwidthRate and RelayBandwidthRate.
448     - Treat "2gb" when given in torrc for a bandwidth as meaning 2gb,
449       minus 1 byte: the actual maximum declared bandwidth.
450     - Make "TrackHostExits ." actually work. Bugfix on 0.1.0.x.
451     - Make the NodeFamilies config option work. (Reported by
452       lodger -- it has never actually worked, even though we added it
453       in Oct 2004.)
454     - If Tor is invoked from something that isn't a shell (e.g. Vidalia),
455       now we expand "-f ~/.tor/torrc" correctly. Suggested by Matt Edman.
457   o New config options:
458     - New configuration options to override default maximum number of
459       servers allowed on a single IP address. This is important for
460       running a test network on a single host. XXX
461     - Three new config options (AlternateDirAuthority,
462       AlternateBridgeAuthority, and AlternateHSAuthority) that let the
463       user selectively replace the default directory authorities by type,
464       rather than the all-or-nothing replacement that DirServer offers.
465     - New config options AuthDirBadDir and AuthDirListBadDirs for
466       authorities to mark certain relays as "bad directories" in the
467       networkstatus documents. Also supports the "!baddir" directive in
468       the approved-routers file.
469     - New config option V2AuthoritativeDirectory that all v2 directory
470       authorities must set. This lets v3 authorities choose not to serve
471       v2 directory information.
473   o Minor features (other):
474     - When we're not serving v2 directory information, there is no reason
475       to actually keep any around. Remove the obsolete files and directory
476       on startup if they are very old and we aren't going to serve them.
477     - When we negotiate a v2 link-layer connection (not yet implemented),
478       accept RELAY_EARLY cells and turn them into RELAY cells if we've
479       negotiated a v1 connection for their next step. Initial steps for
480       proposal 110.
481     - When we have no consensus, check FallbackNetworkstatusFile (defaults
482       to $PREFIX/share/tor/fallback-consensus) for a consensus. This way
483       we can start out knowing some directory caches. We don't ship with
484       a fallback consensus by default though, because it wasn't making
485       bootstrapping take too long while we tried many down relays.
486     - Authorities send back an X-Descriptor-Not-New header in response to
487       an accepted-but-discarded descriptor upload. Partially implements
488       fix for bug 535.
489     - If we find a cached-routers file that's been sitting around for more
490       than 28 days unmodified, then most likely it's a leftover from
491       when we upgraded to 0.2.0.8-alpha. Remove it. It has no good
492       routers anyway.
493     - When we (as a cache) download a descriptor because it was listed
494       in a consensus, remember when the consensus was supposed to expire,
495       and don't expire the descriptor until then.
496     - Optionally (if built with -DEXPORTMALLINFO) export the output
497       of mallinfo via http, as tor/mallinfo.txt. Only accessible
498       from localhost.
499     - Tag every guard node in our state file with the version that
500       we believe added it, or with our own version if we add it. This way,
501       if a user temporarily runs an old version of Tor and then switches
502       back to a new one, she doesn't automatically lose her guards.
503     - When somebody requests a list of statuses or servers, and we have
504       none of those, return a 404 rather than an empty 200.
505     - Merge in some (as-yet-unused) IPv6 address manipulation code. (Patch
506       from croup.)
507     - Add an HSAuthorityRecordStats option that hidden service authorities
508       can use to track statistics of overall hidden service usage without
509       logging information that would be as useful to an attacker.
510     - Allow multiple HiddenServicePort directives with the same virtual
511       port; when they occur, the user is sent round-robin to one
512       of the target ports chosen at random.  Partially fixes bug 393 by
513       adding limited ad-hoc round-robining.
514     - Revamp file-writing logic so we don't need to have the entire
515       contents of a file in memory at once before we write to disk. Tor,
516       meet stdio.
518   o Minor bugfixes (other):
519     - Alter the code that tries to recover from unhandled write
520       errors, to not try to flush onto a socket that's given us
521       unhandled errors.
522     - Directory mirrors no longer include a guess at the client's IP
523       address if the connection appears to be coming from the same /24
524       network; it was producing too many wrong guesses.
525     - If we're trying to flush the last bytes on a connection (for
526       example, when answering a directory request), reset the
527       time-to-give-up timeout every time we manage to write something
528       on the socket.
529     - Reject router descriptors with out-of-range bandwidthcapacity or
530       bandwidthburst values.
531     - If we can't expand our list of entry guards (e.g. because we're
532       using bridges or we have StrictEntryNodes set), don't mark relays
533       down when they fail a directory request. Otherwise we're too quick
534       to mark all our entry points down.
535     - Authorities no longer send back "400 you're unreachable please fix
536       it" errors to Tor servers that aren't online all the time. We're
537       supposed to tolerate these servers now.
538     - Let directory authorities startup even when they can't generate
539       a descriptor immediately, e.g. because they don't know their
540       address.
541     - Correctly enforce that elements of directory objects do not appear
542       more often than they are allowed to appear.
543     - Stop allowing hibernating servers to be "stable" or "fast".
544     - On Windows, we were preventing other processes from reading
545       cached-routers while Tor was running. (Reported by janbar)
546     - Check return values from pthread_mutex functions.
547     - When opening /dev/null in finish_daemonize(), do not pass the
548       O_CREAT flag. Fortify was complaining, and correctly so. Fixes
549       bug 742; fix from Michael Scherer. Bugfix on 0.0.2pre19.
551   o Controller features:
552     - The GETCONF command now escapes and quotes configuration values
553       that don't otherwise fit into the torrc file.
554     - The SETCONF command now handles quoted values correctly.
555     - Add "GETINFO/desc-annotations/id/<OR digest>" so controllers can
556       ask about source, timestamp of arrival, purpose, etc. We need
557       something like this to help Vidalia not do GeoIP lookups on bridge
558       addresses.
559     - Allow multiple HashedControlPassword config lines, to support
560       multiple controller passwords.
561     - Accept LF instead of CRLF on controller, since some software has a
562       hard time generating real Internet newlines.
563     - Add GETINFO values for the server status events
564       "REACHABILITY_SUCCEEDED" and "GOOD_SERVER_DESCRIPTOR". Patch from
565       Robert Hogan.
566     - There is now an ugly, temporary "desc/all-recent-extrainfo-hack"
567       GETINFO for Torstat to use until it can switch to using extrainfos.
568     - New config option CookieAuthFile to choose a new location for the
569       cookie authentication file, and config option
570       CookieAuthFileGroupReadable to make it group-readable.
571     - Add a SOURCE_ADDR field to STREAM NEW events so that controllers can
572       match requests to applications. Patch from Robert Hogan.
573     - Add a RESOLVE command to launch hostname lookups. Original patch
574       from Robert Hogan.
575     - Add GETINFO status/enough-dir-info to let controllers tell whether
576       Tor has downloaded sufficient directory information. Patch from Tup.
577     - You can now use the ControlSocket option to tell Tor to listen for
578       controller connections on Unix domain sockets on systems that
579       support them. Patch from Peter Palfrader.
580     - New "GETINFO address-mappings/*" command to get address mappings
581       with expiry information. "addr-mappings/*" is now deprecated.
582       Patch from Tup.
583     - Add a new config option __DisablePredictedCircuits designed for
584       use by the controller, when we don't want Tor to build any circuits
585       preemptively.
586     - Let the controller specify HOP=%d as an argument to ATTACHSTREAM,
587       so we can exit from the middle of the circuit.
588     - Implement "getinfo status/circuit-established".
589     - Implement "getinfo status/version/..." so a controller can tell
590       whether the current version is recommended, and whether any versions
591       are good, and how many authorities agree. Patch from "shibz".
592     - Controllers should now specify cache=no or cache=yes when using
593       the +POSTDESCRIPTOR command.
594     - Add a "PURPOSE=" argument to "STREAM NEW" events, as suggested by
595       Robert Hogan. Fixes the first part of bug 681.
596     - When reporting clock skew, and we know that the clock is _at least
597       as skewed_ as some value, but we don't know the actual value,
598       report the value as a "minimum skew."
600   o Controller bugfixes:
601     - Generate "STATUS_SERVER" events rather than misspelled
602       "STATUS_SEVER" events. Caught by mwenge.
603     - Reject controller commands over 1MB in length, so rogue
604       processes can't run us out of memory.
605     - Change the behavior of "getinfo status/good-server-descriptor"
606       so it doesn't return failure when any authority disappears.
607     - Send NAMESERVER_STATUS messages for a single failed nameserver
608       correctly.
609     - When the DANGEROUS_VERSION controller status event told us we're
610       running an obsolete version, it used the string "OLD" to describe
611       it. Yet the "getinfo" interface used the string "OBSOLETE". Now use
612       "OBSOLETE" in both cases.
613     - Respond to INT and TERM SIGNAL commands before we execute the
614       signal, in case the signal shuts us down. We had a patch in
615       0.1.2.1-alpha that tried to do this by queueing the response on
616       the connection's buffer before shutting down, but that really
617       isn't the same thing at all. Bug located by Matt Edman.
618     - Provide DNS expiry times in GMT, not in local time. For backward
619       compatibility, ADDRMAP events only provide GMT expiry in an extended
620       field. "GETINFO address-mappings" always does the right thing.
621     - Use CRLF line endings properly in NS events.
622     - Make 'getinfo fingerprint' return a 551 error if we're not a
623       server, so we match what the control spec claims we do. Reported
624       by daejees.
625     - Fix a typo in an error message when extendcircuit fails that
626       caused us to not follow the \r\n-based delimiter protocol. Reported
627       by daejees.
628     - When tunneling an encrypted directory connection, and its first
629       circuit fails, do not leave it unattached and ask the controller
630       to deal. Fixes the second part of bug 681.
631     - Treat some 403 responses from directory servers as INFO rather than
632       WARN-severity events.
634   o Portability / building / compiling:
635     - When building with --enable-gcc-warnings, check for whether Apple's
636       warning "-Wshorten-64-to-32" is available.
637     - Support compilation to target iPhone; patch from cjacker huang.
638       To build for iPhone, pass the --enable-iphone option to configure.
639     - Detect non-ASCII platforms (if any still exist) and refuse to
640       build there: some of our code assumes that 'A' is 65 and so on.
641     - Clear up some MIPSPro compiler warnings.
642     - Make autoconf search for libevent, openssl, and zlib consistently.
643     - Update deprecated macros in configure.in.
644     - When warning about missing headers, tell the user to let us
645       know if the compile succeeds anyway, so we can downgrade the
646       warning.
647     - Include the current subversion revision as part of the version
648       string: either fetch it directly if we're in an SVN checkout, do
649       some magic to guess it if we're in an SVK checkout, or use
650       the last-detected version if we're building from a .tar.gz.
651       Use this version consistently in log messages.
652     - Correctly report platform name on Windows 95 OSR2 and Windows 98 SE.
653     - Read resolv.conf files correctly on platforms where read() returns
654       partial results on small file reads.
655     - Build without verbose warnings even on gcc 4.2 and 4.3.
656     - On Windows, correctly detect errors when listing the contents of
657       a directory. Fix from lodger.
658     - Run 'make test' as part of 'make dist', so we stop releasing so
659       many development snapshots that fail their unit tests.
660     - Add support to detect Libevent versions in the 1.4.x series
661       on mingw.
662     - Add command-line arguments to unit-test executable so that we can
663       invoke any chosen test from the command line rather than having
664       to run the whole test suite at once; and so that we can turn on
665       logging for the unit tests.
666     - Do not automatically run configure from autogen.sh. This
667       non-standard behavior tended to annoy people who have built other
668       programs.
669     - Fix a macro/CPP interaction that was confusing some compilers:
670       some GCCs don't like #if/#endif pairs inside macro arguments.
671       Fixes bug 707.
672     - Fix macro collision between OpenSSL 0.9.8h and Windows headers.
673       Fixes bug 704; fix from Steven Murdoch.
674     - Correctly detect transparent proxy support on Linux hosts that
675       require in.h to be included before netfilter_ipv4.h.  Patch
676       from coderman.
678   o Logging improvements:
679     - When we haven't had any application requests lately, don't bother
680       logging that we have expired a bunch of descriptors.
681     - When attempting to open a logfile fails, tell us why.
682     - Only log guard node status when guard node status has changed.
683     - Downgrade the 3 most common "INFO" messages to "DEBUG". This will
684       make "INFO" 75% less verbose.
685     - When SafeLogging is disabled, log addresses along with all TLS
686       errors.
687     - Report TLS "zero return" case as a "clean close" and "IO error"
688       as a "close". Stop calling closes "unexpected closes": existing
689       Tors don't use SSL_close(), so having a connection close without
690       the TLS shutdown handshake is hardly unexpected.
691     - When we receive a consensus from the future, warn about skew.
692     - Make "not enough dir info yet" warnings describe *why* Tor feels
693       it doesn't have enough directory info yet.
694     - On the USR1 signal, when dmalloc is in use, log the top 10 memory
695       consumers. (We already do this on HUP.)
696     - Give more descriptive well-formedness errors for out-of-range
697       hidden service descriptor/protocol versions.
698     - Stop recommending that every server operator send mail to tor-ops.
699       Resolves bug 597. Bugfix on 0.1.2.x.
700     - Improve skew reporting: try to give the user a better log message
701       about how skewed they are, and how much this matters.
702     - New --quiet command-line option to suppress the default console log.
703       Good in combination with --hash-password.
704     - Don't complain that "your server has not managed to confirm that its
705       ports are reachable" if we haven't been able to build any circuits
706       yet.
707     - Detect the reason for failing to mmap a descriptor file we just
708       wrote, and give a more useful log message.  Fixes bug 533.
709     - Always prepend "Bug: " to any log message about a bug.
710     - When dumping memory usage, list bytes used in buffer memory
711       free-lists.
712     - When running with dmalloc, dump more stats on hup and on exit.
713     - Put a platform string (e.g. "Linux i686") in the startup log
714       message, so when people paste just their logs, we know if it's
715       OpenBSD or Windows or what.
716     - When logging memory usage, break down memory used in buffers by
717       buffer type.
718     - When we are reporting the DirServer line we just parsed, we were
719       logging the second stanza of the key fingerprint, not the first.
720     - Even though Windows is equally happy with / and \ as path separators,
721       try to use \ consistently on Windows and / consistently on Unix: it
722       makes the log messages nicer.
723      - On OSX, stop warning the user that kqueue support in libevent is
724       "experimental", since it seems to have worked fine for ages.
726   o Contributed scripts and tools:
727     - Update linux-tor-prio.sh script to allow QoS based on the uid of
728       the Tor process. Patch from Marco Bonetti with tweaks from Mike
729       Perry.
730     - Include the "tor-ctrl.sh" bash script by Stefan Behte to provide
731       Unix users an easy way to script their Tor process (e.g. by
732       adjusting bandwidth based on the time of the day).
733     - In the exitlist script, only consider the most recently published
734       server descriptor for each server. Also, when the user requests
735       a list of servers that _reject_ connections to a given address,
736       explicitly exclude the IPs that also have servers that accept
737       connections to that address. Resolves bug 405.
738     - Include a new contrib/tor-exit-notice.html file that exit relay
739       operators can put on their website to help reduce abuse queries.
741   o Newly deprecated features:
742     - The status/version/num-versioning and status/version/num-concurring
743       GETINFO controller options are no longer useful in the v3 directory
744       protocol: treat them as deprecated, and warn when they're used.
745     - The RedirectExits config option is now deprecated.
747   o Removed features:
748     - Drop the old code to choke directory connections when the
749       corresponding OR connections got full: thanks to the cell queue
750       feature, OR conns don't get full any more.
751     - Remove the old "dns worker" server DNS code: it hasn't been default
752       since 0.1.2.2-alpha, and all the servers are using the new
753       eventdns code.
754     - Remove the code to generate the oldest (v1) directory format.
755     - Remove support for the old bw_accounting file: we've been storing
756       bandwidth accounting information in the state file since
757       0.1.2.5-alpha. This may result in bandwidth accounting errors
758       if you try to upgrade from 0.1.1.x or earlier, or if you try to
759       downgrade to 0.1.1.x or earlier.
760     - Drop support for OpenSSL version 0.9.6. Just about nobody was using
761       it, it had no AES, and it hasn't seen any security patches since
762       2004.
763     - Stop overloading the circuit_t.onionskin field for both "onionskin
764       from a CREATE cell that we are waiting for a cpuworker to be
765       assigned" and "onionskin from an EXTEND cell that we are going to
766       send to an OR as soon as we are connected". Might help with bug 600.
767     - Remove the tor_strpartition() function: its logic was confused,
768       and it was only used for one thing that could be implemented far
769       more easily.
770     - Remove the contrib scripts ExerciseServer.py, PathDemo.py,
771       and TorControl.py, as they use the old v0 controller protocol,
772       and are obsoleted by TorFlow anyway.
773     - Drop support for v1 rendezvous descriptors, since we never used
774       them anyway, and the code has probably rotted by now. Based on
775       patch from Karsten Loesing.
776     - Stop allowing address masks that do not correspond to bit prefixes.
777       We have warned about these for a really long time; now it's time
778       to reject them. (Patch from croup.)
779     - Remove an optimization in the AES counter-mode code that assumed
780       that the counter never exceeded 2^68. When the counter can be set
781       arbitrarily as an IV (as it is by Karsten's new hidden services
782       code), this assumption no longer holds.
783     - Disable the SETROUTERPURPOSE controller command: it is now
784       obsolete.
787 Changes in version 0.1.2.19 - 2008-01-17
788   Tor 0.1.2.19 fixes a huge memory leak on exit relays, makes the default
789   exit policy a little bit more conservative so it's safer to run an
790   exit relay on a home system, and fixes a variety of smaller issues.
792   o Security fixes:
793     - Exit policies now reject connections that are addressed to a
794       relay's public (external) IP address too, unless
795       ExitPolicyRejectPrivate is turned off. We do this because too
796       many relays are running nearby to services that trust them based
797       on network address.
799   o Major bugfixes:
800     - When the clock jumps forward a lot, do not allow the bandwidth
801       buckets to become negative. Fixes bug 544.
802     - Fix a memory leak on exit relays; we were leaking a cached_resolve_t
803       on every successful resolve. Reported by Mike Perry.
804     - Purge old entries from the "rephist" database and the hidden
805       service descriptor database even when DirPort is zero.
806     - Stop thinking that 0.1.2.x directory servers can handle "begin_dir"
807       requests. Should ease bugs 406 and 419 where 0.1.2.x relays are
808       crashing or mis-answering these requests.
809     - When we decide to send a 503 response to a request for servers, do
810       not then also send the server descriptors: this defeats the whole
811       purpose. Fixes bug 539.
813   o Minor bugfixes:
814     - Changing the ExitPolicyRejectPrivate setting should cause us to
815       rebuild our server descriptor.
816     - Fix handling of hex nicknames when answering controller requests for
817       networkstatus by name, or when deciding whether to warn about
818       unknown routers in a config option. (Patch from mwenge.)
819     - Fix a couple of hard-to-trigger autoconf problems that could result
820       in really weird results on platforms whose sys/types.h files define
821       nonstandard integer types.
822     - Don't try to create the datadir when running --verify-config or
823       --hash-password. Resolves bug 540.
824     - If we were having problems getting a particular descriptor from the
825       directory caches, and then we learned about a new descriptor for
826       that router, we weren't resetting our failure count. Reported
827       by lodger.
828     - Although we fixed bug 539 (where servers would send HTTP status 503
829       responses _and_ send a body too), there are still servers out there
830       that haven't upgraded. Therefore, make clients parse such bodies
831       when they receive them.
832     - Run correctly on systems where rlim_t is larger than unsigned long.
833       This includes some 64-bit systems.
834     - Run correctly on platforms (like some versions of OS X 10.5) where
835       the real limit for number of open files is OPEN_FILES, not rlim_max
836       from getrlimit(RLIMIT_NOFILES).
837     - Avoid a spurious free on base64 failure.
838     - Avoid segfaults on certain complex invocations of
839       router_get_by_hexdigest().
840     - Fix rare bug on REDIRECTSTREAM control command when called with no
841       port set: it could erroneously report an error when none had
842       happened.
845 Changes in version 0.1.2.18 - 2007-10-28
846   Tor 0.1.2.18 fixes many problems including crash bugs, problems with
847   hidden service introduction that were causing huge delays, and a big
848   bug that was causing some servers to disappear from the network status
849   lists for a few hours each day.
851   o Major bugfixes (crashes):
852     - If a connection is shut down abruptly because of something that
853       happened inside connection_flushed_some(), do not call
854       connection_finished_flushing(). Should fix bug 451:
855       "connection_stop_writing: Assertion conn->write_event failed"
856       Bugfix on 0.1.2.7-alpha.
857     - Fix possible segfaults in functions called from
858       rend_process_relay_cell().
860   o Major bugfixes (hidden services):
861     - Hidden services were choosing introduction points uniquely by
862       hexdigest, but when constructing the hidden service descriptor
863       they merely wrote the (potentially ambiguous) nickname.
864     - Clients now use the v2 intro format for hidden service
865       connections: they specify their chosen rendezvous point by identity
866       digest rather than by (potentially ambiguous) nickname. These
867       changes could speed up hidden service connections dramatically.
869   o Major bugfixes (other):
870     - Stop publishing a new server descriptor just because we get a
871       HUP signal. This led (in a roundabout way) to some servers getting
872       dropped from the networkstatus lists for a few hours each day.
873     - When looking for a circuit to cannibalize, consider family as well
874       as identity. Fixes bug 438. Bugfix on 0.1.0.x (which introduced
875       circuit cannibalization).
876     - When a router wasn't listed in a new networkstatus, we were leaving
877       the flags for that router alone -- meaning it remained Named,
878       Running, etc -- even though absence from the networkstatus means
879       that it shouldn't be considered to exist at all anymore. Now we
880       clear all the flags for routers that fall out of the networkstatus
881       consensus. Fixes bug 529.
883   o Minor bugfixes:
884     - Don't try to access (or alter) the state file when running
885       --list-fingerprint or --verify-config or --hash-password. Resolves
886       bug 499.
887     - When generating information telling us how to extend to a given
888       router, do not try to include the nickname if it is
889       absent. Resolves bug 467.
890     - Fix a user-triggerable segfault in expand_filename(). (There isn't
891       a way to trigger this remotely.)
892     - When sending a status event to the controller telling it that an
893       OR address is reachable, set the port correctly. (Previously we
894       were reporting the dir port.)
895     - Fix a minor memory leak whenever a controller sends the PROTOCOLINFO
896       command. Bugfix on 0.1.2.17.
897     - When loading bandwidth history, do not believe any information in
898       the future. Fixes bug 434.
899     - When loading entry guard information, do not believe any information
900       in the future.
901     - When we have our clock set far in the future and generate an
902       onion key, then re-set our clock to be correct, we should not stop
903       the onion key from getting rotated.
904     - On some platforms, accept() can return a broken address. Detect
905       this more quietly, and deal accordingly. Fixes bug 483.
906     - It's not actually an error to find a non-pending entry in the DNS
907       cache when canceling a pending resolve. Don't log unless stuff
908       is fishy. Resolves bug 463.
909     - Don't reset trusted dir server list when we set a configuration
910       option. Patch from Robert Hogan.
913 Changes in version 0.1.2.17 - 2007-08-30
914   Tor 0.1.2.17 features a new Vidalia version in the Windows and OS
915   X bundles. Vidalia 0.0.14 makes authentication required for the
916   ControlPort in the default configuration, which addresses important
917   security risks. Everybody who uses Vidalia (or another controller)
918   should upgrade.
920   In addition, this Tor update fixes major load balancing problems with
921   path selection, which should speed things up a lot once many people
922   have upgraded.
924   o Major bugfixes (security):
925     - We removed support for the old (v0) control protocol. It has been
926       deprecated since Tor 0.1.1.1-alpha, and keeping it secure has
927       become more of a headache than it's worth.
929   o Major bugfixes (load balancing):
930     - When choosing nodes for non-guard positions, weight guards
931       proportionally less, since they already have enough load. Patch
932       from Mike Perry.
933     - Raise the "max believable bandwidth" from 1.5MB/s to 10MB/s. This
934       will allow fast Tor servers to get more attention.
935     - When we're upgrading from an old Tor version, forget our current
936       guards and pick new ones according to the new weightings. These
937       three load balancing patches could raise effective network capacity
938       by a factor of four. Thanks to Mike Perry for measurements.
940   o Major bugfixes (stream expiration):
941     - Expire not-yet-successful application streams in all cases if
942       they've been around longer than SocksTimeout. Right now there are
943       some cases where the stream will live forever, demanding a new
944       circuit every 15 seconds. Fixes bug 454; reported by lodger.
946   o Minor features (controller):
947     - Add a PROTOCOLINFO controller command. Like AUTHENTICATE, it
948       is valid before any authentication has been received. It tells
949       a controller what kind of authentication is expected, and what
950       protocol is spoken. Implements proposal 119.
952   o Minor bugfixes (performance):
953     - Save on most routerlist_assert_ok() calls in routerlist.c, thus
954       greatly speeding up loading cached-routers from disk on startup.
955     - Disable sentinel-based debugging for buffer code: we squashed all
956       the bugs that this was supposed to detect a long time ago, and now
957       its only effect is to change our buffer sizes from nice powers of
958       two (which platform mallocs tend to like) to values slightly over
959       powers of two (which make some platform mallocs sad).
961   o Minor bugfixes (misc):
962     - If exit bandwidth ever exceeds one third of total bandwidth, then
963       use the correct formula to weight exit nodes when choosing paths.
964       Based on patch from Mike Perry.
965     - Choose perfectly fairly among routers when choosing by bandwidth and
966       weighting by fraction of bandwidth provided by exits. Previously, we
967       would choose with only approximate fairness, and correct ourselves
968       if we ran off the end of the list.
969     - If we require CookieAuthentication but we fail to write the
970       cookie file, we would warn but not exit, and end up in a state
971       where no controller could authenticate. Now we exit.
972     - If we require CookieAuthentication, stop generating a new cookie
973       every time we change any piece of our config.
974     - Refuse to start with certain directory authority keys, and
975       encourage people using them to stop.
976     - Terminate multi-line control events properly. Original patch
977       from tup.
978     - Fix a minor memory leak when we fail to find enough suitable
979       servers to choose a circuit.
980     - Stop leaking part of the descriptor when we run into a particularly
981       unparseable piece of it.
984 Changes in version 0.1.2.16 - 2007-08-01
985   Tor 0.1.2.16 fixes a critical security vulnerability that allows a
986   remote attacker in certain situations to rewrite the user's torrc
987   configuration file. This can completely compromise anonymity of users
988   in most configurations, including those running the Vidalia bundles,
989   TorK, etc. Or worse.
991   o Major security fixes:
992     - Close immediately after missing authentication on control port;
993       do not allow multiple authentication attempts.
996 Changes in version 0.1.2.15 - 2007-07-17
997   Tor 0.1.2.15 fixes several crash bugs, fixes some anonymity-related
998   problems, fixes compilation on BSD, and fixes a variety of other
999   bugs. Everybody should upgrade.
1001   o Major bugfixes (compilation):
1002     - Fix compile on FreeBSD/NetBSD/OpenBSD. Oops.
1004   o Major bugfixes (crashes):
1005     - Try even harder not to dereference the first character after
1006       an mmap(). Reported by lodger.
1007     - Fix a crash bug in directory authorities when we re-number the
1008       routerlist while inserting a new router.
1009     - When the cached-routers file is an even multiple of the page size,
1010       don't run off the end and crash. (Fixes bug 455; based on idea
1011       from croup.)
1012     - Fix eventdns.c behavior on Solaris: It is critical to include
1013       orconfig.h _before_ sys/types.h, so that we can get the expected
1014       definition of _FILE_OFFSET_BITS.
1016   o Major bugfixes (security):
1017     - Fix a possible buffer overrun when using BSD natd support. Bug
1018       found by croup.
1019     - When sending destroy cells from a circuit's origin, don't include
1020       the reason for tearing down the circuit. The spec says we didn't,
1021       and now we actually don't. Reported by lodger.
1022     - Keep streamids from different exits on a circuit separate. This
1023       bug may have allowed other routers on a given circuit to inject
1024       cells into streams. Reported by lodger; fixes bug 446.
1025     - If there's a never-before-connected-to guard node in our list,
1026       never choose any guards past it. This way we don't expand our
1027       guard list unless we need to.
1029   o Minor bugfixes (guard nodes):
1030     - Weight guard selection by bandwidth, so that low-bandwidth nodes
1031       don't get overused as guards.
1033   o Minor bugfixes (directory):
1034     - Correctly count the number of authorities that recommend each
1035       version. Previously, we were under-counting by 1.
1036     - Fix a potential crash bug when we load many server descriptors at
1037       once and some of them make others of them obsolete. Fixes bug 458.
1039   o Minor bugfixes (hidden services):
1040     - Stop tearing down the whole circuit when the user asks for a
1041       connection to a port that the hidden service didn't configure.
1042       Resolves bug 444.
1044   o Minor bugfixes (misc):
1045     - On Windows, we were preventing other processes from reading
1046       cached-routers while Tor was running. Reported by janbar.
1047     - Fix a possible (but very unlikely) bug in picking routers by
1048       bandwidth. Add a log message to confirm that it is in fact
1049       unlikely. Patch from lodger.
1050     - Backport a couple of memory leak fixes.
1051     - Backport miscellaneous cosmetic bugfixes.
1054 Changes in version 0.1.2.14 - 2007-05-25
1055   Tor 0.1.2.14 changes the addresses of two directory authorities (this
1056   change especially affects those who serve or use hidden services),
1057   and fixes several other crash- and security-related bugs.
1059   o Directory authority changes:
1060     - Two directory authorities (moria1 and moria2) just moved to new
1061       IP addresses. This change will particularly affect those who serve
1062       or use hidden services.
1064   o Major bugfixes (crashes):
1065     - If a directory server runs out of space in the connection table
1066       as it's processing a begin_dir request, it will free the exit stream
1067       but leave it attached to the circuit, leading to unpredictable
1068       behavior. (Reported by seeess, fixes bug 425.)
1069     - Fix a bug in dirserv_remove_invalid() that would cause authorities
1070       to corrupt memory under some really unlikely scenarios.
1071     - Tighten router parsing rules. (Bugs reported by Benedikt Boss.)
1072     - Avoid segfaults when reading from mmaped descriptor file. (Reported
1073       by lodger.)
1075   o Major bugfixes (security):
1076     - When choosing an entry guard for a circuit, avoid using guards
1077       that are in the same family as the chosen exit -- not just guards
1078       that are exactly the chosen exit. (Reported by lodger.)
1080   o Major bugfixes (resource management):
1081     - If a directory authority is down, skip it when deciding where to get
1082       networkstatus objects or descriptors. Otherwise we keep asking
1083       every 10 seconds forever. Fixes bug 384.
1084     - Count it as a failure if we fetch a valid network-status but we
1085       don't want to keep it. Otherwise we'll keep fetching it and keep
1086       not wanting to keep it. Fixes part of bug 422.
1087     - If all of our dirservers have given us bad or no networkstatuses
1088       lately, then stop hammering them once per minute even when we
1089       think they're failed. Fixes another part of bug 422.
1091   o Minor bugfixes:
1092     - Actually set the purpose correctly for descriptors inserted with
1093       purpose=controller.
1094     - When we have k non-v2 authorities in our DirServer config,
1095       we ignored the last k authorities in the list when updating our
1096       network-statuses.
1097     - Correctly back-off from requesting router descriptors that we are
1098       having a hard time downloading.
1099     - Read resolv.conf files correctly on platforms where read() returns
1100       partial results on small file reads.
1101     - Don't rebuild the entire router store every time we get 32K of
1102       routers: rebuild it when the journal gets very large, or when
1103       the gaps in the store get very large.
1105   o Minor features:
1106     - When routers publish SVN revisions in their router descriptors,
1107       authorities now include those versions correctly in networkstatus
1108       documents.
1109     - Warn when using a version of libevent before 1.3b to run a server on
1110       OSX or BSD: these versions interact badly with userspace threads.
1113 Changes in version 0.1.2.13 - 2007-04-24
1114   This release features some major anonymity fixes, such as safer path
1115   selection; better client performance; faster bootstrapping, better
1116   address detection, and better DNS support for servers; write limiting as
1117   well as read limiting to make servers easier to run; and a huge pile of
1118   other features and bug fixes. The bundles also ship with Vidalia 0.0.11.
1120   Tor 0.1.2.13 is released in memory of Rob Levin (1955-2006), aka lilo
1121   of the Freenode IRC network, remembering his patience and vision for
1122   free speech on the Internet.
1124   o Major features, client performance:
1125     - Weight directory requests by advertised bandwidth. Now we can
1126       let servers enable write limiting but still allow most clients to
1127       succeed at their directory requests. (We still ignore weights when
1128       choosing a directory authority; I hope this is a feature.)
1129     - Stop overloading exit nodes -- avoid choosing them for entry or
1130       middle hops when the total bandwidth available from non-exit nodes
1131       is much higher than the total bandwidth available from exit nodes.
1132     - Rather than waiting a fixed amount of time between retrying
1133       application connections, we wait only 10 seconds for the first,
1134       10 seconds for the second, and 15 seconds for each retry after
1135       that. Hopefully this will improve the expected user experience.
1136     - Sometimes we didn't bother sending a RELAY_END cell when an attempt
1137       to open a stream fails; now we do in more cases. This should
1138       make clients able to find a good exit faster in some cases, since
1139       unhandleable requests will now get an error rather than timing out.
1141   o Major features, client functionality:
1142     - Implement BEGIN_DIR cells, so we can connect to a directory
1143       server via TLS to do encrypted directory requests rather than
1144       plaintext. Enable via the TunnelDirConns and PreferTunneledDirConns
1145       config options if you like. For now, this feature only works if
1146       you already have a descriptor for the destination dirserver.
1147     - Add support for transparent application connections: this basically
1148       bundles the functionality of trans-proxy-tor into the Tor
1149       mainline. Now hosts with compliant pf/netfilter implementations
1150       can redirect TCP connections straight to Tor without diverting
1151       through SOCKS. (Based on patch from tup.)
1152     - Add support for using natd; this allows FreeBSDs earlier than
1153       5.1.2 to have ipfw send connections through Tor without using
1154       SOCKS. (Patch from Zajcev Evgeny with tweaks from tup.)
1156   o Major features, servers:
1157     - Setting up a dyndns name for your server is now optional: servers
1158       with no hostname or IP address will learn their IP address by
1159       asking the directory authorities. This code only kicks in when you
1160       would normally have exited with a "no address" error. Nothing's
1161       authenticated, so use with care.
1162     - Directory servers now spool server descriptors, v1 directories,
1163       and v2 networkstatus objects to buffers as needed rather than en
1164       masse. They also mmap the cached-routers files. These steps save
1165       lots of memory.
1166     - Stop requiring clients to have well-formed certificates, and stop
1167       checking nicknames in certificates. (Clients have certificates so
1168       that they can look like Tor servers, but in the future we might want
1169       to allow them to look like regular TLS clients instead. Nicknames
1170       in certificates serve no purpose other than making our protocol
1171       easier to recognize on the wire.) Implements proposal 106.
1173   o Improvements on DNS support:
1174     - Add "eventdns" asynchronous dns library originally based on code
1175       from Adam Langley. Now we can discard the old rickety dnsworker
1176       concept, and support a wider variety of DNS functions. Allows
1177       multithreaded builds on NetBSD and OpenBSD again.
1178     - Add server-side support for "reverse" DNS lookups (using PTR
1179       records so clients can determine the canonical hostname for a given
1180       IPv4 address). Only supported by servers using eventdns; servers
1181       now announce in their descriptors if they don't support eventdns.
1182     - Workaround for name servers (like Earthlink's) that hijack failing
1183       DNS requests and replace the no-such-server answer with a "helpful"
1184       redirect to an advertising-driven search portal. Also work around
1185       DNS hijackers who "helpfully" decline to hijack known-invalid
1186       RFC2606 addresses. Config option "ServerDNSDetectHijacking 0"
1187       lets you turn it off.
1188     - Servers now check for the case when common DNS requests are going to
1189       wildcarded addresses (i.e. all getting the same answer), and change
1190       their exit policy to reject *:* if it's happening.
1191     - When asked to resolve a hostname, don't use non-exit servers unless
1192       requested to do so. This allows servers with broken DNS to be
1193       useful to the network.
1194     - Start passing "ipv4" hints to getaddrinfo(), so servers don't do
1195       useless IPv6 DNS resolves.
1196     - Specify and implement client-side SOCKS5 interface for reverse DNS
1197       lookups (see doc/socks-extensions.txt). Also cache them.
1198     - When we change nameservers or IP addresses, reset and re-launch
1199       our tests for DNS hijacking.
1201   o Improvements on reachability testing:
1202     - Servers send out a burst of long-range padding cells once they've
1203       established that they're reachable. Spread them over 4 circuits,
1204       so hopefully a few will be fast. This exercises bandwidth and
1205       bootstraps them into the directory more quickly.
1206     - When we find our DirPort to be reachable, publish a new descriptor
1207       so we'll tell the world (reported by pnx).
1208     - Directory authorities now only decide that routers are reachable
1209       if their identity keys are as expected.
1210     - Do DirPort reachability tests less often, since a single test
1211       chews through many circuits before giving up.
1212     - Avoid some false positives during reachability testing: don't try
1213       to test via a server that's on the same /24 network as us.
1214     - Start publishing one minute or so after we find our ORPort
1215       to be reachable. This will help reduce the number of descriptors
1216       we have for ourselves floating around, since it's quite likely
1217       other things (e.g. DirPort) will change during that minute too.
1218     - Routers no longer try to rebuild long-term connections to directory
1219       authorities, and directory authorities no longer try to rebuild
1220       long-term connections to all servers. We still don't hang up
1221       connections in these two cases though -- we need to look at it
1222       more carefully to avoid flapping, and we likely need to wait til
1223       0.1.1.x is obsolete.
1225   o Improvements on rate limiting:
1226     - Enable write limiting as well as read limiting. Now we sacrifice
1227       capacity if we're pushing out lots of directory traffic, rather
1228       than overrunning the user's intended bandwidth limits.
1229     - Include TLS overhead when counting bandwidth usage; previously, we
1230       would count only the bytes sent over TLS, but not the bytes used
1231       to send them.
1232     - Servers decline directory requests much more aggressively when
1233       they're low on bandwidth. Otherwise they end up queueing more and
1234       more directory responses, which can't be good for latency.
1235     - But never refuse directory requests from local addresses.
1236     - Be willing to read or write on local connections (e.g. controller
1237       connections) even when the global rate limiting buckets are empty.
1238     - Flush local controller connection buffers periodically as we're
1239       writing to them, so we avoid queueing 4+ megabytes of data before
1240       trying to flush.
1241     - Revise and clean up the torrc.sample that we ship with; add
1242       a section for BandwidthRate and BandwidthBurst.
1244   o Major features, NT services:
1245     - Install as NT_AUTHORITY\LocalService rather than as SYSTEM; add a
1246       command-line flag so that admins can override the default by saying
1247       "tor --service install --user "SomeUser"". This will not affect
1248       existing installed services. Also, warn the user that the service
1249       will look for its configuration file in the service user's
1250       %appdata% directory. (We can't do the "hardwire the user's appdata
1251       directory" trick any more, since we may not have read access to that
1252       directory.)
1253     - Support running the Tor service with a torrc not in the same
1254       directory as tor.exe and default to using the torrc located in
1255       the %appdata%\Tor\ of the user who installed the service. Patch
1256       from Matt Edman.
1257     - Add an --ignore-missing-torrc command-line option so that we can
1258       get the "use sensible defaults if the configuration file doesn't
1259       exist" behavior even when specifying a torrc location on the
1260       command line.
1261     - When stopping an NT service, wait up to 10 sec for it to actually
1262       stop. (Patch from Matt Edman; resolves bug 295.)
1264   o Directory authority improvements:
1265     - Stop letting hibernating or obsolete servers affect uptime and
1266       bandwidth cutoffs.
1267     - Stop listing hibernating servers in the v1 directory.
1268     - Authorities no longer recommend exits as guards if this would shift
1269       too much load to the exit nodes.
1270     - Authorities now specify server versions in networkstatus. This adds
1271       about 2% to the size of compressed networkstatus docs, and allows
1272       clients to tell which servers support BEGIN_DIR and which don't.
1273       The implementation is forward-compatible with a proposed future
1274       protocol version scheme not tied to Tor versions.
1275     - DirServer configuration lines now have an orport= option so
1276       clients can open encrypted tunnels to the authorities without
1277       having downloaded their descriptors yet. Enabled for moria1,
1278       moria2, tor26, and lefkada now in the default configuration.
1279     - Add a BadDirectory flag to network status docs so that authorities
1280       can (eventually) tell clients about caches they believe to be
1281       broken. Not used yet.
1282     - Allow authorities to list nodes as bad exits in their
1283       approved-routers file by fingerprint or by address. If most
1284       authorities set a BadExit flag for a server, clients don't think
1285       of it as a general-purpose exit. Clients only consider authorities
1286       that advertise themselves as listing bad exits.
1287     - Patch from Steve Hildrey: Generate network status correctly on
1288       non-versioning dirservers.
1289     - Have directory authorities allow larger amounts of drift in uptime
1290       without replacing the server descriptor: previously, a server that
1291       restarted every 30 minutes could have 48 "interesting" descriptors
1292       per day.
1293     - Reserve the nickname "Unnamed" for routers that can't pick
1294       a hostname: any router can call itself Unnamed; directory
1295       authorities will never allocate Unnamed to any particular router;
1296       clients won't believe that any router is the canonical Unnamed.
1298   o Directory mirrors and clients:
1299     - Discard any v1 directory info that's over 1 month old (for
1300       directories) or over 1 week old (for running-routers lists).
1301     - Clients track responses with status 503 from dirservers. After a
1302       dirserver has given us a 503, we try not to use it until an hour has
1303       gone by, or until we have no dirservers that haven't given us a 503.
1304     - When we get a 503 from a directory, and we're not a server, we no
1305       longer count the failure against the total number of failures
1306       allowed for the object we're trying to download.
1307     - Prepare for servers to publish descriptors less often: never
1308       discard a descriptor simply for being too old until either it is
1309       recommended by no authorities, or until we get a better one for
1310       the same router. Make caches consider retaining old recommended
1311       routers for even longer.
1312     - Directory servers now provide 'Pragma: no-cache' and 'Expires'
1313       headers for content, so that we can work better in the presence of
1314       caching HTTP proxies.
1315     - Stop fetching descriptors if you're not a dir mirror and you
1316       haven't tried to establish any circuits lately. (This currently
1317       causes some dangerous behavior, because when you start up again
1318       you'll use your ancient server descriptors.)
1320   o Major fixes, crashes:
1321     - Stop crashing when the controller asks us to resetconf more than
1322       one config option at once. (Vidalia 0.0.11 does this.)
1323     - Fix a longstanding obscure crash bug that could occur when we run
1324       out of DNS worker processes, if we're not using eventdns. (Resolves
1325       bug 390.)
1326     - Fix an assert that could trigger if a controller quickly set then
1327       cleared EntryNodes. (Bug found by Udo van den Heuvel.)
1328     - Avoid crash when telling controller about stream-status and a
1329       stream is detached.
1330     - Avoid sending junk to controllers or segfaulting when a controller
1331       uses EVENT_NEW_DESC with verbose nicknames.
1332     - Stop triggering asserts if the controller tries to extend hidden
1333       service circuits (reported by mwenge).
1334     - If we start a server with ClientOnly 1, then set ClientOnly to 0
1335       and hup, stop triggering an assert based on an empty onion_key.
1336     - Mask out all signals in sub-threads; only the libevent signal
1337       handler should be processing them. This should prevent some crashes
1338       on some machines using pthreads. (Patch from coderman.)
1339     - Disable kqueue on OS X 10.3 and earlier, to fix bug 371.
1341   o Major fixes, anonymity/security:
1342     - Automatically avoid picking more than one node from the same
1343       /16 network when constructing a circuit. Add an
1344       "EnforceDistinctSubnets" option to let people disable it if they
1345       want to operate private test networks on a single subnet.
1346     - When generating bandwidth history, round down to the nearest
1347       1k. When storing accounting data, round up to the nearest 1k.
1348     - When we're running as a server, remember when we last rotated onion
1349       keys, so that we will rotate keys once they're a week old even if
1350       we never stay up for a week ourselves.
1351     - If a client asked for a server by name, and there's a named server
1352       in our network-status but we don't have its descriptor yet, we
1353       could return an unnamed server instead.
1354     - Reject (most) attempts to use Tor circuits with length one. (If
1355       many people start using Tor as a one-hop proxy, exit nodes become
1356       a more attractive target for compromise.)
1357     - Just because your DirPort is open doesn't mean people should be
1358       able to remotely teach you about hidden service descriptors. Now
1359       only accept rendezvous posts if you've got HSAuthoritativeDir set.
1360     - Fix a potential race condition in the rpm installer. Found by
1361       Stefan Nordhausen.
1362     - Do not log IPs with TLS failures for incoming TLS
1363       connections. (Fixes bug 382.)
1365   o Major fixes, other:
1366     - If our system clock jumps back in time, don't publish a negative
1367       uptime in the descriptor.
1368     - When we start during an accounting interval before it's time to wake
1369       up, remember to wake up at the correct time. (May fix bug 342.)
1370     - Previously, we would cache up to 16 old networkstatus documents
1371       indefinitely, if they came from nontrusted authorities. Now we
1372       discard them if they are more than 10 days old.
1373     - When we have a state file we cannot parse, tell the user and
1374       move it aside. Now we avoid situations where the user starts
1375       Tor in 1904, Tor writes a state file with that timestamp in it,
1376       the user fixes her clock, and Tor refuses to start.
1377     - Publish a new descriptor after we hup/reload. This is important
1378       if our config has changed such that we'll want to start advertising
1379       our DirPort now, etc.
1380     - If we are using an exit enclave and we can't connect, e.g. because
1381       its webserver is misconfigured to not listen on localhost, then
1382       back off and try connecting from somewhere else before we fail.
1384   o New config options or behaviors:
1385     - When EntryNodes are configured, rebuild the guard list to contain,
1386       in order: the EntryNodes that were guards before; the rest of the
1387       EntryNodes; the nodes that were guards before.
1388     - Do not warn when individual nodes in the configuration's EntryNodes,
1389       ExitNodes, etc are down: warn only when all possible nodes
1390       are down. (Fixes bug 348.)
1391     - Put a lower-bound on MaxAdvertisedBandwidth.
1392     - Start using the state file to store bandwidth accounting data:
1393       the bw_accounting file is now obsolete. We'll keep generating it
1394       for a while for people who are still using 0.1.2.4-alpha.
1395     - Try to batch changes to the state file so that we do as few
1396       disk writes as possible while still storing important things in
1397       a timely fashion.
1398     - The state file and the bw_accounting file get saved less often when
1399       the AvoidDiskWrites config option is set.
1400     - Make PIDFile work on Windows.
1401     - Add internal descriptions for a bunch of configuration options:
1402       accessible via controller interface and in comments in saved
1403       options files.
1404     - Reject *:563 (NNTPS) in the default exit policy. We already reject
1405       NNTP by default, so this seems like a sensible addition.
1406     - Clients now reject hostnames with invalid characters. This should
1407       avoid some inadvertent info leaks. Add an option
1408       AllowNonRFC953Hostnames to disable this behavior, in case somebody
1409       is running a private network with hosts called @, !, and #.
1410     - Check for addresses with invalid characters at the exit as well,
1411       and warn less verbosely when they fail. You can override this by
1412       setting ServerDNSAllowNonRFC953Addresses to 1.
1413     - Remove some options that have been deprecated since at least
1414       0.1.0.x: AccountingMaxKB, LogFile, DebugLogFile, LogLevel, and
1415       SysLog. Use AccountingMax instead of AccountingMaxKB, and use Log
1416       to set log options. Mark PathlenCoinWeight as obsolete.
1417     - Stop accepting certain malformed ports in configured exit policies.
1418     - When the user uses bad syntax in the Log config line, stop
1419       suggesting other bad syntax as a replacement.
1420     - Add new config option "ResolvConf" to let the server operator
1421       choose an alternate resolve.conf file when using eventdns.
1422     - If one of our entry guards is on the ExcludeNodes list, or the
1423       directory authorities don't think it's a good guard, treat it as
1424       if it were unlisted: stop using it as a guard, and throw it off
1425       the guards list if it stays that way for a long time.
1426     - Allow directory authorities to be marked separately as authorities
1427       for the v1 directory protocol, the v2 directory protocol, and
1428       as hidden service directories, to make it easier to retire old
1429       authorities. V1 authorities should set "HSAuthoritativeDir 1"
1430       to continue being hidden service authorities too.
1431     - Remove 8888 as a LongLivedPort, and add 6697 (IRCS).
1432     - Make TrackExitHosts case-insensitive, and fix the behavior of
1433       ".suffix" TrackExitHosts items to avoid matching in the middle of
1434       an address.
1435     - New DirPort behavior: if you have your dirport set, you download
1436       descriptors aggressively like a directory mirror, whether or not
1437       your ORPort is set.
1439   o Docs:
1440     - Create a new file ReleaseNotes which was the old ChangeLog. The
1441       new ChangeLog file now includes the notes for all development
1442       versions too.
1443     - Add a new address-spec.txt document to describe our special-case
1444       addresses: .exit, .onion, and .noconnnect.
1445     - Fork the v1 directory protocol into its own spec document,
1446       and mark dir-spec.txt as the currently correct (v2) spec.
1448   o Packaging, porting, and contrib
1449     - "tor --verify-config" now exits with -1(255) or 0 depending on
1450       whether the config options are bad or good.
1451     - The Debian package now uses --verify-config when (re)starting,
1452       to distinguish configuration errors from other errors.
1453     - Adapt a patch from goodell to let the contrib/exitlist script
1454       take arguments rather than require direct editing.
1455     - Prevent the contrib/exitlist script from printing the same
1456       result more than once.
1457     - Add support to tor-resolve tool for reverse lookups and SOCKS5.
1458     - In the hidden service example in torrc.sample, stop recommending
1459       esoteric and discouraged hidden service options.
1460     - Patch from Michael Mohr to contrib/cross.sh, so it checks more
1461       values before failing, and always enables eventdns.
1462     - Try to detect Windows correctly when cross-compiling.
1463     - Libevent-1.2 exports, but does not define in its headers, strlcpy.
1464       Try to fix this in configure.in by checking for most functions
1465       before we check for libevent.
1466     - Update RPMs to require libevent 1.2.
1467     - Experimentally re-enable kqueue on OSX when using libevent 1.1b
1468       or later. Log when we are doing this, so we can diagnose it when
1469       it fails. (Also, recommend libevent 1.1b for kqueue and
1470       win32 methods; deprecate libevent 1.0b harder; make libevent
1471       recommendation system saner.)
1472     - Build with recent (1.3+) libevents on platforms that do not
1473       define the nonstandard types "u_int8_t" and friends.
1474     - Remove architecture from OS X builds. The official builds are
1475       now universal binaries.
1476     - Run correctly on OS X platforms with case-sensitive filesystems.
1477     - Correctly set maximum connection limit on Cygwin. (This time
1478       for sure!)
1479     - Start compiling on MinGW on Windows (patches from Mike Chiussi
1480       and many others).
1481     - Start compiling on MSVC6 on Windows (patches from Frediano Ziglio).
1482     - Finally fix the openssl warnings from newer gccs that believe that
1483       ignoring a return value is okay, but casting a return value and
1484       then ignoring it is a sign of madness.
1485     - On architectures where sizeof(int)>4, still clamp declarable
1486       bandwidth to INT32_MAX.
1488   o Minor features, controller:
1489     - Warn the user when an application uses the obsolete binary v0
1490       control protocol. We're planning to remove support for it during
1491       the next development series, so it's good to give people some
1492       advance warning.
1493     - Add STREAM_BW events to report per-entry-stream bandwidth
1494       use. (Patch from Robert Hogan.)
1495     - Rate-limit SIGNEWNYM signals in response to controllers that
1496       impolitely generate them for every single stream. (Patch from
1497       mwenge; closes bug 394.)
1498     - Add a REMAP status to stream events to note that a stream's
1499       address has changed because of a cached address or a MapAddress
1500       directive.
1501     - Make REMAP stream events have a SOURCE (cache or exit), and
1502       make them generated in every case where we get a successful
1503       connected or resolved cell.
1504     - Track reasons for OR connection failure; make these reasons
1505       available via the controller interface. (Patch from Mike Perry.)
1506     - Add a SOCKS_BAD_HOSTNAME client status event so controllers
1507       can learn when clients are sending malformed hostnames to Tor.
1508     - Specify and implement some of the controller status events.
1509     - Have GETINFO dir/status/* work on hosts with DirPort disabled.
1510     - Reimplement GETINFO so that info/names stays in sync with the
1511       actual keys.
1512     - Implement "GETINFO fingerprint".
1513     - Implement "SETEVENTS GUARD" so controllers can get updates on
1514       entry guard status as it changes.
1515     - Make all connections to addresses of the form ".noconnect"
1516       immediately get closed. This lets application/controller combos
1517       successfully test whether they're talking to the same Tor by
1518       watching for STREAM events.
1519     - Add a REASON field to CIRC events; for backward compatibility, this
1520       field is sent only to controllers that have enabled the extended
1521       event format. Also, add additional reason codes to explain why
1522       a given circuit has been destroyed or truncated. (Patches from
1523       Mike Perry)
1524     - Add a REMOTE_REASON field to extended CIRC events to tell the
1525       controller why a remote OR told us to close a circuit.
1526     - Stream events also now have REASON and REMOTE_REASON fields,
1527       working much like those for circuit events.
1528     - There's now a GETINFO ns/... field so that controllers can ask Tor
1529       about the current status of a router.
1530     - A new event type "NS" to inform a controller when our opinion of
1531       a router's status has changed.
1532     - Add a GETINFO events/names and GETINFO features/names so controllers
1533       can tell which events and features are supported.
1534     - A new CLEARDNSCACHE signal to allow controllers to clear the
1535       client-side DNS cache without expiring circuits.
1536     - Fix CIRC controller events so that controllers can learn the
1537       identity digests of non-Named servers used in circuit paths.
1538     - Let controllers ask for more useful identifiers for servers. Instead
1539       of learning identity digests for un-Named servers and nicknames
1540       for Named servers, the new identifiers include digest, nickname,
1541       and indication of Named status. Off by default; see control-spec.txt
1542       for more information.
1543     - Add a "getinfo address" controller command so it can display Tor's
1544       best guess to the user.
1545     - New controller event to alert the controller when our server
1546       descriptor has changed.
1547     - Give more meaningful errors on controller authentication failure.
1548     - Export the default exit policy via the control port, so controllers
1549       don't need to guess what it is / will be later.
1551   o Minor bugfixes, controller:
1552     - When creating a circuit via the controller, send a 'launched'
1553       event when we're done, so we follow the spec better.
1554     - Correct the control spec to match how the code actually responds
1555       to 'getinfo addr-mappings/*'. Reported by daejees.
1556     - The control spec described a GUARDS event, but the code
1557       implemented a GUARD event. Standardize on GUARD, but let people
1558       ask for GUARDS too. Reported by daejees.
1559     - Give the controller END_STREAM_REASON_DESTROY events _before_ we
1560       clear the corresponding on_circuit variable, and remember later
1561       that we don't need to send a redundant CLOSED event. (Resolves part
1562       3 of bug 367.)
1563     - Report events where a resolve succeeded or where we got a socks
1564       protocol error correctly, rather than calling both of them
1565       "INTERNAL".
1566     - Change reported stream target addresses to IP consistently when
1567       we finally get the IP from an exit node.
1568     - Send log messages to the controller even if they happen to be very
1569       long.
1570     - Flush ERR-level controller status events just like we currently
1571       flush ERR-level log events, so that a Tor shutdown doesn't prevent
1572       the controller from learning about current events.
1573     - Report the circuit number correctly in STREAM CLOSED events. Bug
1574       reported by Mike Perry.
1575     - Do not report bizarre values for results of accounting GETINFOs
1576       when the last second's write or read exceeds the allotted bandwidth.
1577     - Report "unrecognized key" rather than an empty string when the
1578       controller tries to fetch a networkstatus that doesn't exist.
1579     - When the controller does a "GETINFO network-status", tell it
1580       about even those routers whose descriptors are very old, and use
1581       long nicknames where appropriate.
1582     - Fix handling of verbose nicknames with ORCONN controller events:
1583       make them show up exactly when requested, rather than exactly when
1584       not requested.
1585     - Controller signals now work on non-Unix platforms that don't define
1586       SIGUSR1 and SIGUSR2 the way we expect.
1587     - Respond to SIGNAL command before we execute the signal, in case
1588       the signal shuts us down. Suggested by Karsten Loesing.
1589     - Handle reporting OR_CONN_EVENT_NEW events to the controller.
1591   o Minor features, code performance:
1592     - Major performance improvement on inserting descriptors: change
1593       algorithm from O(n^2) to O(n).
1594     - Do not rotate onion key immediately after setting it for the first
1595       time.
1596     - Call router_have_min_dir_info half as often. (This is showing up in
1597       some profiles, but not others.)
1598     - When using GCC, make log_debug never get called at all, and its
1599       arguments never get evaluated, when no debug logs are configured.
1600       (This is showing up in some profiles, but not others.)
1601     - Statistics dumped by -USR2 now include a breakdown of public key
1602       operations, for profiling.
1603     - Make the common memory allocation path faster on machines where
1604       malloc(0) returns a pointer.
1605     - Split circuit_t into origin_circuit_t and or_circuit_t, and
1606       split connection_t into edge, or, dir, control, and base structs.
1607       These will save quite a bit of memory on busy servers, and they'll
1608       also help us track down bugs in the code and bugs in the spec.
1609     - Use OpenSSL's AES implementation on platforms where it's faster.
1610       This could save us as much as 10% CPU usage.
1612   o Minor features, descriptors and descriptor handling:
1613     - Avoid duplicate entries on MyFamily line in server descriptor.
1614     - When Tor receives a router descriptor that it asked for, but
1615       no longer wants (because it has received fresh networkstatuses
1616       in the meantime), do not warn the user. Cache the descriptor if
1617       we're a cache; drop it if we aren't.
1618     - Servers no longer ever list themselves in their "family" line,
1619       even if configured to do so. This makes it easier to configure
1620       family lists conveniently.
1622   o Minor fixes, confusing/misleading log messages:
1623     - Display correct results when reporting which versions are
1624       recommended, and how recommended they are. (Resolves bug 383.)
1625     - Inform the server operator when we decide not to advertise a
1626       DirPort due to AccountingMax enabled or a low BandwidthRate.
1627     - Only include function names in log messages for info/debug messages.
1628       For notice/warn/err, the content of the message should be clear on
1629       its own, and printing the function name only confuses users.
1630     - Remove even more protocol-related warnings from Tor server logs,
1631       such as bad TLS handshakes and malformed begin cells.
1632     - Fix bug 314: Tor clients issued "unsafe socks" warnings even
1633       when the IP address is mapped through MapAddress to a hostname.
1634     - Fix misleading log messages: an entry guard that is "unlisted",
1635       as well as not known to be "down" (because we've never heard
1636       of it), is not therefore "up".
1638   o Minor fixes, old/obsolete behavior:
1639     - Start assuming we can use a create_fast cell if we don't know
1640       what version a router is running.
1641     - We no longer look for identity and onion keys in "identity.key" and
1642       "onion.key" -- these were replaced by secret_id_key and
1643       secret_onion_key in 0.0.8pre1.
1644     - We no longer require unrecognized directory entries to be
1645       preceded by "opt".
1646     - Drop compatibility with obsolete Tors that permit create cells
1647       to have the wrong circ_id_type.
1648     - Remove code to special-case "-cvs" ending, since it has not
1649       actually mattered since 0.0.9.
1650     - Don't re-write the fingerprint file every restart, unless it has
1651       changed.
1653   o Minor fixes, misc client-side behavior:
1654     - Always remove expired routers and networkstatus docs before checking
1655       whether we have enough information to build circuits. (Fixes
1656       bug 373.)
1657     - When computing clock skew from directory HTTP headers, consider what
1658       time it was when we finished asking for the directory, not what
1659       time it is now.
1660     - Make our socks5 handling more robust to broken socks clients:
1661       throw out everything waiting on the buffer in between socks
1662       handshake phases, since they can't possibly (so the theory
1663       goes) have predicted what we plan to respond to them.
1664     - Expire socks connections if they spend too long waiting for the
1665       handshake to finish. Previously we would let them sit around for
1666       days, if the connecting application didn't close them either.
1667     - And if the socks handshake hasn't started, don't send a
1668       "DNS resolve socks failed" handshake reply; just close it.
1669     - If the user asks to use invalid exit nodes, be willing to use
1670       unstable ones.
1671     - Track unreachable entry guards correctly: don't conflate
1672       'unreachable by us right now' with 'listed as down by the directory
1673       authorities'. With the old code, if a guard was unreachable by us
1674       but listed as running, it would clog our guard list forever.
1675     - Behave correctly in case we ever have a network with more than
1676       2GB/s total advertised capacity.
1677     - Claim a commonname of Tor, rather than TOR, in TLS handshakes.
1678     - Fix a memory leak when we ask for "all" networkstatuses and we
1679       get one we don't recognize.
1682 Changes in version 0.1.1.26 - 2006-12-14
1683   o Security bugfixes:
1684     - Stop sending the HttpProxyAuthenticator string to directory
1685       servers when directory connections are tunnelled through Tor.
1686     - Clients no longer store bandwidth history in the state file.
1687     - Do not log introduction points for hidden services if SafeLogging
1688       is set.
1690   o Minor bugfixes:
1691     - Fix an assert failure when a directory authority sets
1692       AuthDirRejectUnlisted and then receives a descriptor from an
1693       unlisted router (reported by seeess).
1696 Changes in version 0.1.1.25 - 2006-11-04
1697   o Major bugfixes:
1698     - When a client asks us to resolve (rather than connect to)
1699       an address, and we have a cached answer, give them the cached
1700       answer. Previously, we would give them no answer at all.
1701     - We were building exactly the wrong circuits when we predict
1702       hidden service requirements, meaning Tor would have to build all
1703       its circuits on demand.
1704     - If none of our live entry guards have a high uptime, but we
1705       require a guard with a high uptime, try adding a new guard before
1706       we give up on the requirement. This patch should make long-lived
1707       connections more stable on average.
1708     - When testing reachability of our DirPort, don't launch new
1709       tests when there's already one in progress -- unreachable
1710       servers were stacking up dozens of testing streams.
1712   o Security bugfixes:
1713     - When the user sends a NEWNYM signal, clear the client-side DNS
1714       cache too. Otherwise we continue to act on previous information.
1716   o Minor bugfixes:
1717     - Avoid a memory corruption bug when creating a hash table for
1718       the first time.
1719     - Avoid possibility of controller-triggered crash when misusing
1720       certain commands from a v0 controller on platforms that do not
1721       handle printf("%s",NULL) gracefully.
1722     - Avoid infinite loop on unexpected controller input.
1723     - Don't log spurious warnings when we see a circuit close reason we
1724       don't recognize; it's probably just from a newer version of Tor.
1725     - Add Vidalia to the OS X uninstaller script, so when we uninstall
1726       Tor/Privoxy we also uninstall Vidalia.
1729 Changes in version 0.1.1.24 - 2006-09-29
1730   o Major bugfixes:
1731     - Allow really slow clients to not hang up five minutes into their
1732       directory downloads (suggested by Adam J. Richter).
1733     - Fix major performance regression from 0.1.0.x: instead of checking
1734       whether we have enough directory information every time we want to
1735       do something, only check when the directory information has changed.
1736       This should improve client CPU usage by 25-50%.
1737     - Don't crash if, after a server has been running for a while,
1738       it can't resolve its hostname.
1739     - When a client asks us to resolve (not connect to) an address,
1740       and we have a cached answer, give them the cached answer.
1741       Previously, we would give them no answer at all.
1743   o Minor bugfixes:
1744     - Allow Tor to start when RunAsDaemon is set but no logs are set.
1745     - Don't crash when the controller receives a third argument to an
1746       "extendcircuit" request.
1747     - Controller protocol fixes: fix encoding in "getinfo addr-mappings"
1748       response; fix error code when "getinfo dir/status/" fails.
1749     - Fix configure.in to not produce broken configure files with
1750       more recent versions of autoconf. Thanks to Clint for his auto*
1751       voodoo.
1752     - Fix security bug on NetBSD that could allow someone to force
1753       uninitialized RAM to be sent to a server's DNS resolver. This
1754       only affects NetBSD and other platforms that do not bounds-check
1755       tolower().
1756     - Warn user when using libevent 1.1a or earlier with win32 or kqueue
1757       methods: these are known to be buggy.
1758     - If we're a directory mirror and we ask for "all" network status
1759       documents, we would discard status documents from authorities
1760       we don't recognize.
1763 Changes in version 0.1.1.23 - 2006-07-30
1764   o Major bugfixes:
1765     - Fast Tor servers, especially exit nodes, were triggering asserts
1766       due to a bug in handling the list of pending DNS resolves. Some
1767       bugs still remain here; we're hunting them.
1768     - Entry guards could crash clients by sending unexpected input.
1769     - More fixes on reachability testing: if you find yourself reachable,
1770       then don't ever make any client requests (so you stop predicting
1771       circuits), then hup or have your clock jump, then later your IP
1772       changes, you won't think circuits are working, so you won't try to
1773       test reachability, so you won't publish.
1775   o Minor bugfixes:
1776     - Avoid a crash if the controller does a resetconf firewallports
1777       and then a setconf fascistfirewall=1.
1778     - Avoid an integer underflow when the dir authority decides whether
1779       a router is stable: we might wrongly label it stable, and compute
1780       a slightly wrong median stability, when a descriptor is published
1781       later than now.
1782     - Fix a place where we might trigger an assert if we can't build our
1783       own server descriptor yet.
1786 Changes in version 0.1.1.22 - 2006-07-05
1787   o Major bugfixes:
1788     - Fix a big bug that was causing servers to not find themselves
1789       reachable if they changed IP addresses. Since only 0.1.1.22+
1790       servers can do reachability testing correctly, now we automatically
1791       make sure to test via one of these.
1792     - Fix to allow clients and mirrors to learn directory info from
1793       descriptor downloads that get cut off partway through.
1794     - Directory authorities had a bug in deciding if a newly published
1795       descriptor was novel enough to make everybody want a copy -- a few
1796       servers seem to be publishing new descriptors many times a minute.
1797   o Minor bugfixes:
1798     - Fix a rare bug that was causing some servers to complain about
1799       "closing wedged cpuworkers" and skip some circuit create requests.
1800     - Make the Exit flag in directory status documents actually work.
1803 Changes in version 0.1.1.21 - 2006-06-10
1804   o Crash and assert fixes from 0.1.1.20:
1805     - Fix a rare crash on Tor servers that have enabled hibernation.
1806     - Fix a seg fault on startup for Tor networks that use only one
1807       directory authority.
1808     - Fix an assert from a race condition that occurs on Tor servers
1809       while exiting, where various threads are trying to log that they're
1810       exiting, and delete the logs, at the same time.
1811     - Make our unit tests pass again on certain obscure platforms.
1813   o Other fixes:
1814     - Add support for building SUSE RPM packages.
1815     - Speed up initial bootstrapping for clients: if we are making our
1816       first ever connection to any entry guard, then don't mark it down
1817       right after that.
1818     - When only one Tor server in the network is labelled as a guard,
1819       and we've already picked him, we would cycle endlessly picking him
1820       again, being unhappy about it, etc. Now we specifically exclude
1821       current guards when picking a new guard.
1822     - Servers send create cells more reliably after the TLS connection
1823       is established: we were sometimes forgetting to send half of them
1824       when we had more than one pending.
1825     - If we get a create cell that asks us to extend somewhere, but the
1826       Tor server there doesn't match the expected digest, we now send
1827       a destroy cell back, rather than silently doing nothing.
1828     - Make options->RedirectExit work again.
1829     - Make cookie authentication for the controller work again.
1830     - Stop being picky about unusual characters in the arguments to
1831       mapaddress. It's none of our business.
1832     - Add a new config option "TestVia" that lets you specify preferred
1833       middle hops to use for test circuits. Perhaps this will let me
1834       debug the reachability problems better.
1836   o Log / documentation fixes:
1837     - If we're a server and some peer has a broken TLS certificate, don't
1838       log about it unless ProtocolWarnings is set, i.e., we want to hear
1839       about protocol violations by others.
1840     - Fix spelling of VirtualAddrNetwork in man page.
1841     - Add a better explanation at the top of the autogenerated torrc file
1842       about what happened to our old torrc.
1845 Changes in version 0.1.1.20 - 2006-05-23
1846   o Crash and assert fixes from 0.1.0.17:
1847     - Fix assert bug in close_logs() on exit: when we close and delete
1848       logs, remove them all from the global "logfiles" list.
1849     - Fix an assert error when we're out of space in the connection_list
1850       and we try to post a hidden service descriptor (reported by Peter
1851       Palfrader).
1852     - Fix a rare assert error when we've tried all intro points for
1853       a hidden service and we try fetching the service descriptor again:
1854       "Assertion conn->state != AP_CONN_STATE_RENDDESC_WAIT failed".
1855     - Setconf SocksListenAddress kills Tor if it fails to bind. Now back
1856       out and refuse the setconf if it would fail.
1857     - If you specify a relative torrc path and you set RunAsDaemon in
1858       your torrc, then it chdir()'s to the new directory. If you then
1859       HUP, it tries to load the new torrc location, fails, and exits.
1860       The fix: no longer allow a relative path to torrc when using -f.
1861     - Check for integer overflows in more places, when adding elements
1862       to smartlists. This could possibly prevent a buffer overflow
1863       on malicious huge inputs.
1865   o Security fixes, major:
1866     - When we're printing strings from the network, don't try to print
1867       non-printable characters. Now we're safer against shell escape
1868       sequence exploits, and also against attacks to fool users into
1869       misreading their logs.
1870     - Implement entry guards: automatically choose a handful of entry
1871       nodes and stick with them for all circuits. Only pick new guards
1872       when the ones you have are unsuitable, and if the old guards
1873       become suitable again, switch back. This will increase security
1874       dramatically against certain end-point attacks. The EntryNodes
1875       config option now provides some hints about which entry guards you
1876       want to use most; and StrictEntryNodes means to only use those.
1877       Fixes CVE-2006-0414.
1878     - Implement exit enclaves: if we know an IP address for the
1879       destination, and there's a running Tor server at that address
1880       which allows exit to the destination, then extend the circuit to
1881       that exit first. This provides end-to-end encryption and end-to-end
1882       authentication. Also, if the user wants a .exit address or enclave,
1883       use 4 hops rather than 3, and cannibalize a general circ for it
1884       if you can.
1885     - Obey our firewall options more faithfully:
1886       . If we can't get to a dirserver directly, try going via Tor.
1887       . Don't ever try to connect (as a client) to a place our
1888         firewall options forbid.
1889       . If we specify a proxy and also firewall options, obey the
1890         firewall options even when we're using the proxy: some proxies
1891         can only proxy to certain destinations.
1892     - Make clients regenerate their keys when their IP address changes.
1893     - For the OS X package's modified privoxy config file, comment
1894       out the "logfile" line so we don't log everything passed
1895       through privoxy.
1896     - Our TLS handshakes were generating a single public/private
1897       keypair for the TLS context, rather than making a new one for
1898       each new connection. Oops. (But we were still rotating them
1899       periodically, so it's not so bad.)
1900     - When we were cannibalizing a circuit with a particular exit
1901       node in mind, we weren't checking to see if that exit node was
1902       already present earlier in the circuit. Now we are.
1903     - Require server descriptors to list IPv4 addresses -- hostnames
1904       are no longer allowed. This also fixes potential vulnerabilities
1905       to servers providing hostnames as their address and then
1906       preferentially resolving them so they can partition users.
1907     - Our logic to decide if the OR we connected to was the right guy
1908       was brittle and maybe open to a mitm for invalid routers.
1910   o Security fixes, minor:
1911     - Adjust tor-spec.txt to parameterize cell and key lengths. Now
1912       Ian Goldberg can prove things about our handshake protocol more
1913       easily.
1914     - Make directory authorities generate a separate "guard" flag to
1915       mean "would make a good entry guard". Clients now honor the
1916       is_guard flag rather than looking at is_fast or is_stable.
1917     - Try to list MyFamily elements by key, not by nickname, and warn
1918       if we've not heard of a server.
1919     - Start using RAND_bytes rather than RAND_pseudo_bytes from
1920       OpenSSL. Also, reseed our entropy every hour, not just at
1921       startup. And add entropy in 512-bit chunks, not 160-bit chunks.
1922     - Refuse server descriptors where the fingerprint line doesn't match
1923       the included identity key. Tor doesn't care, but other apps (and
1924       humans) might actually be trusting the fingerprint line.
1925     - We used to kill the circuit when we receive a relay command we
1926       don't recognize. Now we just drop that cell.
1927     - Fix a bug found by Lasse Overlier: when we were making internal
1928       circuits (intended to be cannibalized later for rendezvous and
1929       introduction circuits), we were picking them so that they had
1930       useful exit nodes. There was no need for this, and it actually
1931       aids some statistical attacks.
1932     - Start treating internal circuits and exit circuits separately.
1933       It's important to keep them separate because internal circuits
1934       have their last hops picked like middle hops, rather than like
1935       exit hops. So exiting on them will break the user's expectations.
1936     - Fix a possible way to DoS dirservers.
1937     - When the client asked for a rendezvous port that the hidden
1938       service didn't want to provide, we were sending an IP address
1939       back along with the end cell. Fortunately, it was zero. But stop
1940       that anyway.
1942   o Packaging improvements:
1943     - Implement --with-libevent-dir option to ./configure. Improve
1944       search techniques to find libevent, and use those for openssl too.
1945     - Fix a couple of bugs in OpenSSL detection. Deal better when
1946       there are multiple SSLs installed with different versions.
1947     - Avoid warnings about machine/limits.h on Debian GNU/kFreeBSD.
1948     - On non-gcc compilers (e.g. Solaris's cc), use "-g -O" instead of
1949       "-Wall -g -O2".
1950     - Make unit tests (and other invocations that aren't the real Tor)
1951       run without launching listeners, creating subdirectories, and so on.
1952     - The OS X installer was adding a symlink for tor_resolve but
1953       the binary was called tor-resolve (reported by Thomas Hardly).
1954     - Now we can target arch and OS in rpm builds (contributed by
1955       Phobos). Also make the resulting dist-rpm filename match the
1956       target arch.
1957     - Apply Matt Ghali's --with-syslog-facility patch to ./configure
1958       if you log to syslog and want something other than LOG_DAEMON.
1959     - Fix the torify (tsocks) config file to not use Tor for localhost
1960       connections.
1961     - Start shipping socks-extensions.txt, tor-doc-unix.html,
1962       tor-doc-server.html, and stylesheet.css in the tarball.
1963     - Stop shipping tor-doc.html, INSTALL, and README in the tarball.
1964       They are useless now.
1965     - Add Peter Palfrader's contributed check-tor script. It lets you
1966       easily check whether a given server (referenced by nickname)
1967       is reachable by you.
1968     - Add BSD-style contributed startup script "rc.subr" from Peter
1969       Thoenen.
1971   o Directory improvements -- new directory protocol:
1972     - See tor/doc/dir-spec.txt for all the juicy details. Key points:
1973     - Authorities and caches publish individual descriptors (by
1974       digest, by fingerprint, by "all", and by "tell me yours").
1975     - Clients don't download or use the old directory anymore. Now they
1976       download network-statuses from the directory authorities, and
1977       fetch individual server descriptors as needed from mirrors.
1978     - Clients don't download descriptors of non-running servers.
1979     - Download descriptors by digest, not by fingerprint. Caches try to
1980       download all listed digests from authorities; clients try to
1981       download "best" digests from caches. This avoids partitioning
1982       and isolating attacks better.
1983     - Only upload a new server descriptor when options change, 18
1984       hours have passed, uptime is reset, or bandwidth changes a lot.
1985     - Directory authorities silently throw away new descriptors that
1986       haven't changed much if the timestamps are similar. We do this to
1987       tolerate older Tor servers that upload a new descriptor every 15
1988       minutes. (It seemed like a good idea at the time.)
1989     - Clients choose directory servers from the network status lists,
1990       not from their internal list of router descriptors. Now they can
1991       go to caches directly rather than needing to go to authorities
1992       to bootstrap the first set of descriptors.
1993     - When picking a random directory, prefer non-authorities if any
1994       are known.
1995     - Add a new flag to network-status indicating whether the server
1996       can answer v2 directory requests too.
1997     - Directory mirrors now cache up to 16 unrecognized network-status
1998       docs, so new directory authorities will be cached too.
1999     - Stop parsing, storing, or using running-routers output (but
2000       mirrors still cache and serve it).
2001     - Clients consider a threshold of "versioning" directory authorities
2002       before deciding whether to warn the user that he's obsolete.
2003     - Authorities publish separate sorted lists of recommended versions
2004       for clients and for servers.
2005     - Change DirServers config line to note which dirs are v1 authorities.
2006     - Put nicknames on the DirServer line, so we can refer to them
2007       without requiring all our users to memorize their IP addresses.
2008     - Remove option when getting directory cache to see whether they
2009       support running-routers; they all do now. Replace it with one
2010       to see whether caches support v2 stuff.
2011     - Stop listing down or invalid nodes in the v1 directory. This
2012       reduces its bulk by about 1/3, and reduces load on mirrors.
2013     - Mirrors no longer cache the v1 directory as often.
2014     - If we as a directory mirror don't know of any v1 directory
2015       authorities, then don't try to cache any v1 directories.
2017   o Other directory improvements:
2018     - Add lefkada.eecs.harvard.edu and tor.dizum.com as fourth and
2019       fifth authoritative directory servers.
2020     - Directory authorities no longer require an open connection from
2021       a server to consider him "reachable". We need this change because
2022       when we add new directory authorities, old servers won't know not
2023       to hang up on them.
2024     - Dir authorities now do their own external reachability testing
2025       of each server, and only list as running the ones they found to
2026       be reachable. We also send back warnings to the server's logs if
2027       it uploads a descriptor that we already believe is unreachable.
2028     - Spread the directory authorities' reachability testing over the
2029       entire testing interval, so we don't try to do 500 TLS's at once
2030       every 20 minutes.
2031     - Make the "stable" router flag in network-status be the median of
2032       the uptimes of running valid servers, and make clients pay
2033       attention to the network-status flags. Thus the cutoff adapts
2034       to the stability of the network as a whole, making IRC, IM, etc
2035       connections more reliable.
2036     - Make the v2 dir's "Fast" flag based on relative capacity, just
2037       like "Stable" is based on median uptime. Name everything in the
2038       top 7/8 Fast, and only the top 1/2 gets to be a Guard.
2039     - Retry directory requests if we fail to get an answer we like
2040       from a given dirserver (we were retrying before, but only if
2041       we fail to connect).
2042     - Return a robots.txt on our dirport to discourage google indexing.
2044   o Controller protocol improvements:
2045     - Revised controller protocol (version 1) that uses ascii rather
2046       than binary: tor/doc/control-spec.txt. Add supporting libraries
2047       in python and java and c# so you can use the controller from your
2048       applications without caring how our protocol works.
2049     - Allow the DEBUG controller event to work again. Mark certain log
2050       entries as "don't tell this to controllers", so we avoid cycles.
2051     - New controller function "getinfo accounting", to ask how
2052       many bytes we've used in this time period.
2053     - Add a "resetconf" command so you can set config options like
2054       AllowUnverifiedNodes and LongLivedPorts to "". Also, if you give
2055       a config option in the torrc with no value, then it clears it
2056       entirely (rather than setting it to its default).
2057     - Add a "getinfo config-file" to tell us where torrc is. Also
2058       expose guard nodes, config options/names.
2059     - Add a "quit" command (when when using the controller manually).
2060     - Add a new signal "newnym" to "change pseudonyms" -- that is, to
2061       stop using any currently-dirty circuits for new streams, so we
2062       don't link new actions to old actions. This also occurs on HUP
2063       or "signal reload".
2064     - If we would close a stream early (e.g. it asks for a .exit that
2065       we know would refuse it) but the LeaveStreamsUnattached config
2066       option is set by the controller, then don't close it.
2067     - Add a new controller event type "authdir_newdescs" that allows
2068       controllers to get all server descriptors that were uploaded to
2069       a router in its role as directory authority.
2070     - New controller option "getinfo desc/all-recent" to fetch the
2071       latest server descriptor for every router that Tor knows about.
2072     - Fix the controller's "attachstream 0" command to treat conn like
2073       it just connected, doing address remapping, handling .exit and
2074       .onion idioms, and so on. Now we're more uniform in making sure
2075       that the controller hears about new and closing connections.
2076     - Permit transitioning from ORPort==0 to ORPort!=0, and back, from
2077       the controller. Also, rotate dns and cpu workers if the controller
2078       changes options that will affect them; and initialize the dns
2079       worker cache tree whether or not we start out as a server.
2080     - Add a new circuit purpose 'controller' to let the controller ask
2081       for a circuit that Tor won't try to use. Extend the "extendcircuit"
2082       controller command to let you specify the purpose if you're starting
2083       a new circuit.  Add a new "setcircuitpurpose" controller command to
2084       let you change a circuit's purpose after it's been created.
2085     - Let the controller ask for "getinfo dir/server/foo" so it can ask
2086       directly rather than connecting to the dir port. "getinfo
2087       dir/status/foo" also works, but currently only if your DirPort
2088       is enabled.
2089     - Let the controller tell us about certain router descriptors
2090       that it doesn't want Tor to use in circuits. Implement
2091       "setrouterpurpose" and modify "+postdescriptor" to do this.
2092     - If the controller's *setconf commands fail, collect an error
2093       message in a string and hand it back to the controller -- don't
2094       just tell them to go read their logs.
2096   o Scalability, resource management, and performance:
2097     - Fix a major load balance bug: we were round-robin reading in 16 KB
2098       chunks, and servers with bandwidthrate of 20 KB, while downloading
2099       a 600 KB directory, would starve their other connections. Now we
2100       try to be a bit more fair.
2101     - Be more conservative about whether to advertise our DirPort.
2102       The main change is to not advertise if we're running at capacity
2103       and either a) we could hibernate ever or b) our capacity is low
2104       and we're using a default DirPort.
2105     - We weren't cannibalizing circuits correctly for
2106       CIRCUIT_PURPOSE_C_ESTABLISH_REND and
2107       CIRCUIT_PURPOSE_S_ESTABLISH_INTRO, so we were being forced to
2108       build those from scratch. This should make hidden services faster.
2109     - Predict required circuits better, with an eye toward making hidden
2110       services faster on the service end.
2111     - Compress exit policies even more: look for duplicate lines and
2112       remove them.
2113     - Generate 18.0.0.0/8 address policy format in descs when we can;
2114       warn when the mask is not reducible to a bit-prefix.
2115     - There used to be two ways to specify your listening ports in a
2116       server descriptor: on the "router" line and with a separate "ports"
2117       line. Remove support for the "ports" line.
2118     - Reduce memory requirements in our structs by changing the order
2119       of fields. Replace balanced trees with hash tables. Inline
2120       bottleneck smartlist functions. Add a "Map from digest to void*"
2121       abstraction so we can do less hex encoding/decoding, and use it
2122       in router_get_by_digest(). Many other CPU and memory improvements.
2123     - Allow tor_gzip_uncompress to extract as much as possible from
2124       truncated compressed data. Try to extract as many
2125       descriptors as possible from truncated http responses (when
2126       purpose is DIR_PURPOSE_FETCH_ROUTERDESC).
2127     - Make circ->onionskin a pointer, not a static array. moria2 was using
2128       125000 circuit_t's after it had been up for a few weeks, which
2129       translates to 20+ megs of wasted space.
2130     - The private half of our EDH handshake keys are now chosen out
2131       of 320 bits, not 1024 bits. (Suggested by Ian Goldberg.)
2132     - Stop doing the complex voodoo overkill checking for insecure
2133       Diffie-Hellman keys. Just check if it's in [2,p-2] and be happy.
2134     - Do round-robin writes for TLS of at most 16 kB per write. This
2135       might be more fair on loaded Tor servers.
2136     - Do not use unaligned memory access on alpha, mips, or mipsel.
2137       It *works*, but is very slow, so we treat them as if it doesn't.
2139   o Other bugfixes and improvements:
2140     - Start storing useful information to $DATADIR/state, so we can
2141       remember things across invocations of Tor. Retain unrecognized
2142       lines so we can be forward-compatible, and write a TorVersion line
2143       so we can be backward-compatible.
2144     - If ORPort is set, Address is not explicitly set, and our hostname
2145       resolves to a private IP address, try to use an interface address
2146       if it has a public address. Now Windows machines that think of
2147       themselves as localhost can guess their address.
2148     - Regenerate our local descriptor if it's dirty and we try to use
2149       it locally (e.g. if it changes during reachability detection).
2150       This was causing some Tor servers to keep publishing the same
2151       initial descriptor forever.
2152     - Tor servers with dynamic IP addresses were needing to wait 18
2153       hours before they could start doing reachability testing using
2154       the new IP address and ports. This is because they were using
2155       the internal descriptor to learn what to test, yet they were only
2156       rebuilding the descriptor once they decided they were reachable.
2157     - It turns out we couldn't bootstrap a network since we added
2158       reachability detection in 0.1.0.1-rc. Good thing the Tor network
2159       has never gone down. Add an AssumeReachable config option to let
2160       servers and authorities bootstrap. When we're trying to build a
2161       high-uptime or high-bandwidth circuit but there aren't enough
2162       suitable servers, try being less picky rather than simply failing.
2163     - Newly bootstrapped Tor networks couldn't establish hidden service
2164       circuits until they had nodes with high uptime. Be more tolerant.
2165     - Really busy servers were keeping enough circuits open on stable
2166       connections that they were wrapping around the circuit_id
2167       space. (It's only two bytes.) This exposed a bug where we would
2168       feel free to reuse a circuit_id even if it still exists but has
2169       been marked for close. Try to fix this bug. Some bug remains.
2170     - When we fail to bind or listen on an incoming or outgoing
2171       socket, we now close it before refusing, rather than just
2172       leaking it. (Thanks to Peter Palfrader for finding.)
2173     - Fix a file descriptor leak in start_daemon().
2174     - On Windows, you can't always reopen a port right after you've
2175       closed it. So change retry_listeners() to only close and re-open
2176       ports that have changed.
2177     - Workaround a problem with some http proxies that refuse GET
2178       requests that specify "Content-Length: 0". Reported by Adrian.
2179     - Recover better from TCP connections to Tor servers that are
2180       broken but don't tell you (it happens!); and rotate TLS
2181       connections once a week.
2182     - Fix a scary-looking but apparently harmless bug where circuits
2183       would sometimes start out in state CIRCUIT_STATE_OR_WAIT at
2184       servers, and never switch to state CIRCUIT_STATE_OPEN.
2185     - Check for even more Windows version flags when writing the platform
2186       string in server descriptors, and note any we don't recognize.
2187     - Add reasons to DESTROY and RELAY_TRUNCATED cells, so clients can
2188       get a better idea of why their circuits failed. Not used yet.
2189     - Add TTLs to RESOLVED, CONNECTED, and END_REASON_EXITPOLICY cells.
2190       We don't use them yet, but maybe one day our DNS resolver will be
2191       able to discover them.
2192     - Let people type "tor --install" as well as "tor -install" when they
2193       want to make it an NT service.
2194     - Looks like we were never delivering deflated (i.e. compressed)
2195       running-routers lists, even when asked. Oops.
2196     - We were leaking some memory every time the client changed IPs.
2197     - Clean up more of the OpenSSL memory when exiting, so we can detect
2198       memory leaks better.
2199     - Never call free() on tor_malloc()d memory. This will help us
2200       use dmalloc to detect memory leaks.
2201     - Some Tor servers process billions of cells per day. These
2202       statistics are now uint64_t's.
2203     - Check [X-]Forwarded-For headers in HTTP requests when generating
2204       log messages. This lets people run dirservers (and caches) behind
2205       Apache but still know which IP addresses are causing warnings.
2206     - Fix minor integer overflow in calculating when we expect to use up
2207       our bandwidth allocation before hibernating.
2208     - Lower the minimum required number of file descriptors to 1000,
2209       so we can have some overhead for Valgrind on Linux, where the
2210       default ulimit -n is 1024.
2211     - Stop writing the "router.desc" file, ever. Nothing uses it anymore,
2212       and its existence is confusing some users.
2214   o Config option fixes:
2215     - Add a new config option ExitPolicyRejectPrivate which defaults
2216       to on. Now all exit policies will begin with rejecting private
2217       addresses, unless the server operator explicitly turns it off.
2218     - Bump the default bandwidthrate to 3 MB, and burst to 6 MB.
2219     - Add new ReachableORAddresses and ReachableDirAddresses options
2220       that understand address policies. FascistFirewall is now a synonym
2221       for "ReachableORAddresses *:443", "ReachableDirAddresses *:80".
2222     - Start calling it FooListenAddress rather than FooBindAddress,
2223       since few of our users know what it means to bind an address
2224       or port.
2225     - If the user gave Tor an odd number of command-line arguments,
2226       we were silently ignoring the last one. Now we complain and fail.
2227       This wins the oldest-bug prize -- this bug has been present since
2228       November 2002, as released in Tor 0.0.0.
2229     - If you write "HiddenServicePort 6667 127.0.0.1 6668" in your
2230       torrc rather than "HiddenServicePort 6667 127.0.0.1:6668",
2231       it would silently ignore the 6668.
2232     - If we get a linelist or linelist_s config option from the torrc,
2233       e.g. ExitPolicy, and it has no value, warn and skip rather than
2234       silently resetting it to its default.
2235     - Setconf was appending items to linelists, not clearing them.
2236     - Add MyFamily to torrc.sample in the server section, so operators
2237       will be more likely to learn that it exists.
2238     - Make ContactInfo mandatory for authoritative directory servers.
2239     - MaxConn has been obsolete for a while now. Document the ConnLimit
2240       config option, which is a *minimum* number of file descriptors
2241       that must be available else Tor refuses to start.
2242     - Get rid of IgnoreVersion undocumented config option, and make us
2243       only warn, never exit, when we're running an obsolete version.
2244     - Make MonthlyAccountingStart config option truly obsolete now.
2245     - Correct the man page entry on TrackHostExitsExpire.
2246     - Let directory authorities start even if they don't specify an
2247       Address config option.
2248     - Change "AllowUnverifiedNodes" to "AllowInvalidNodes", to
2249       reflect the updated flags in our v2 dir protocol.
2251   o Config option features:
2252     - Add a new config option FastFirstHopPK (on by default) so clients
2253       do a trivial crypto handshake for their first hop, since TLS has
2254       already taken care of confidentiality and authentication.
2255     - Let the user set ControlListenAddress in the torrc. This can be
2256       dangerous, but there are some cases (like a secured LAN) where it
2257       makes sense.
2258     - New config options to help controllers: FetchServerDescriptors
2259       and FetchHidServDescriptors for whether to fetch server
2260       info and hidserv info or let the controller do it, and
2261       PublishServerDescriptor and PublishHidServDescriptors.
2262     - Also let the controller set the __AllDirActionsPrivate config
2263       option if you want all directory fetches/publishes to happen via
2264       Tor (it assumes your controller bootstraps your circuits).
2265     - Add "HardwareAccel" config option: support for crypto hardware
2266       accelerators via OpenSSL. Off by default, until we find somebody
2267       smart who can test it for us. (It appears to produce seg faults
2268       in at least some cases.)
2269     - New config option "AuthDirRejectUnlisted" for directory authorities
2270       as a panic button: if we get flooded with unusable servers we can
2271       revert to only listing servers in the approved-routers file.
2272     - Directory authorities can now reject/invalidate by key and IP,
2273       with the config options "AuthDirInvalid" and "AuthDirReject", or
2274       by marking a fingerprint as "!reject" or "!invalid" (as its
2275       nickname) in the approved-routers file. This is useful since
2276       currently we automatically list servers as running and usable
2277       even if we know they're jerks.
2278     - Add a new config option TestSocks so people can see whether their
2279       applications are using socks4, socks4a, socks5-with-ip, or
2280       socks5-with-fqdn. This way they don't have to keep mucking
2281       with tcpdump and wondering if something got cached somewhere.
2282     - Add "private:*" as an alias in configuration for policies. Now
2283       you can simplify your exit policy rather than needing to list
2284       every single internal or nonroutable network space.
2285     - Accept "private:*" in routerdesc exit policies; not generated yet
2286       because older Tors do not understand it.
2287     - Add configuration option "V1AuthoritativeDirectory 1" which
2288       moria1, moria2, and tor26 have set.
2289     - Implement an option, VirtualAddrMask, to set which addresses
2290       get handed out in response to mapaddress requests. This works
2291       around a bug in tsocks where 127.0.0.0/8 is never socksified.
2292     - Add a new config option FetchUselessDescriptors, off by default,
2293       for when you plan to run "exitlist" on your client and you want
2294       to know about even the non-running descriptors.
2295     - SocksTimeout: How long do we let a socks connection wait
2296       unattached before we fail it?
2297     - CircuitBuildTimeout: Cull non-open circuits that were born
2298       at least this many seconds ago.
2299     - CircuitIdleTimeout: Cull open clean circuits that were born
2300       at least this many seconds ago.
2301     - New config option SafeSocks to reject all application connections
2302       using unsafe socks protocols. Defaults to off.
2304   o Improved and clearer log messages:
2305     - Reduce clutter in server logs. We're going to try to make
2306       them actually usable now. New config option ProtocolWarnings that
2307       lets you hear about how _other Tors_ are breaking the protocol. Off
2308       by default.
2309     - Divide log messages into logging domains. Once we put some sort
2310       of interface on this, it will let people looking at more verbose
2311       log levels specify the topics they want to hear more about.
2312     - Log server fingerprint on startup, so new server operators don't
2313       have to go hunting around their filesystem for it.
2314     - Provide dire warnings to any users who set DirServer manually;
2315       move it out of torrc.sample and into torrc.complete.
2316     - Make the log message less scary when all the dirservers are
2317       temporarily unreachable.
2318     - When tor_socketpair() fails in Windows, give a reasonable
2319       Windows-style errno back.
2320     - Improve tor_gettimeofday() granularity on windows.
2321     - We were printing the number of idle dns workers incorrectly when
2322       culling them.
2323     - Handle duplicate lines in approved-routers files without warning.
2324     - We were whining about using socks4 or socks5-with-local-lookup
2325       even when it's an IP address in the "virtual" range we designed
2326       exactly for this case.
2327     - Check for named servers when looking them up by nickname;
2328       warn when we're calling a non-named server by its nickname;
2329       don't warn twice about the same name.
2330     - Downgrade the dirserver log messages when whining about
2331       unreachability.
2332     - Correct "your server is reachable" log entries to indicate that
2333       it was self-testing that told us so.
2334     - If we're trying to be a Tor server and running Windows 95/98/ME
2335       as a server, explain that we'll likely crash.
2336     - Provide a more useful warn message when our onion queue gets full:
2337       the CPU is too slow or the exit policy is too liberal.
2338     - Don't warn when we receive a 503 from a dirserver/cache -- this
2339       will pave the way for them being able to refuse if they're busy.
2340     - When we fail to bind a listener, try to provide a more useful
2341       log message: e.g., "Is Tor already running?"
2342     - Only start testing reachability once we've established a
2343       circuit. This will make startup on dir authorities less noisy.
2344     - Don't try to upload hidden service descriptors until we have
2345       established a circuit.
2346     - Tor didn't warn when it failed to open a log file.
2347     - Warn when listening on a public address for socks. We suspect a
2348       lot of people are setting themselves up as open socks proxies,
2349       and they have no idea that jerks on the Internet are using them,
2350       since they simply proxy the traffic into the Tor network.
2351     - Give a useful message when people run Tor as the wrong user,
2352       rather than telling them to start chowning random directories.
2353     - Fix a harmless bug that was causing Tor servers to log
2354       "Got an end because of misc error, but we're not an AP. Closing."
2355     - Fix wrong log message when you add a "HiddenServiceNodes" config
2356       line without any HiddenServiceDir line (reported by Chris Thomas).
2357     - Directory authorities now stop whining so loudly about bad
2358       descriptors that they fetch from other dirservers. So when there's
2359       a log complaint, it's for sure from a freshly uploaded descriptor.
2360     - When logging via syslog, include the pid whenever we provide
2361       a log entry. Suggested by Todd Fries.
2362     - When we're shutting down and we do something like try to post a
2363       server descriptor or rendezvous descriptor, don't complain that
2364       we seem to be unreachable. Of course we are, we're shutting down.
2365     - Change log line for unreachability to explicitly suggest /etc/hosts
2366       as the culprit. Also make it clearer what IP address and ports we're
2367       testing for reachability.
2368     - Put quotes around user-supplied strings when logging so users are
2369       more likely to realize if they add bad characters (like quotes)
2370       to the torrc.
2371     - NT service patch from Matt Edman to improve error messages on Win32.
2374 Changes in version 0.1.0.17 - 2006-02-17
2375   o Crash bugfixes on 0.1.0.x:
2376     - When servers with a non-zero DirPort came out of hibernation,
2377       sometimes they would trigger an assert.
2379   o Other important bugfixes:
2380     - On platforms that don't have getrlimit (like Windows), we were
2381       artificially constraining ourselves to a max of 1024
2382       connections. Now just assume that we can handle as many as 15000
2383       connections. Hopefully this won't cause other problems.
2385   o Backported features:
2386     - When we're a server, a client asks for an old-style directory,
2387       and our write bucket is empty, don't give it to him. This way
2388       small servers can continue to serve the directory *sometimes*,
2389       without getting overloaded.
2390     - Whenever you get a 503 in response to a directory fetch, try
2391       once more. This will become important once servers start sending
2392       503's whenever they feel busy.
2393     - Fetch a new directory every 120 minutes, not every 40 minutes.
2394       Now that we have hundreds of thousands of users running the old
2395       directory algorithm, it's starting to hurt a lot.
2396     - Bump up the period for forcing a hidden service descriptor upload
2397       from 20 minutes to 1 hour.
2400 Changes in version 0.1.0.16 - 2006-01-02
2401   o Crash bugfixes on 0.1.0.x:
2402     - On Windows, build with a libevent patch from "I-M Weasel" to avoid
2403       corrupting the heap, losing FDs, or crashing when we need to resize
2404       the fd_sets. (This affects the Win32 binaries, not Tor's sources.)
2405     - It turns out sparc64 platforms crash on unaligned memory access
2406       too -- so detect and avoid this.
2407     - Handle truncated compressed data correctly (by detecting it and
2408       giving an error).
2409     - Fix possible-but-unlikely free(NULL) in control.c.
2410     - When we were closing connections, there was a rare case that
2411       stomped on memory, triggering seg faults and asserts.
2412     - Avoid potential infinite recursion when building a descriptor. (We
2413       don't know that it ever happened, but better to fix it anyway.)
2414     - We were neglecting to unlink marked circuits from soon-to-close OR
2415       connections, which caused some rare scribbling on freed memory.
2416     - Fix a memory stomping race bug when closing the joining point of two
2417       rendezvous circuits.
2418     - Fix an assert in time parsing found by Steven Murdoch.
2420   o Other bugfixes on 0.1.0.x:
2421     - When we're doing reachability testing, provide more useful log
2422       messages so the operator knows what to expect.
2423     - Do not check whether DirPort is reachable when we are suppressing
2424       advertising it because of hibernation.
2425     - When building with -static or on Solaris, we sometimes needed -ldl.
2426     - One of the dirservers (tor26) changed its IP address.
2427     - When we're deciding whether a stream has enough circuits around
2428       that can handle it, count the freshly dirty ones and not the ones
2429       that are so dirty they won't be able to handle it.
2430     - When we're expiring old circuits, we had a logic error that caused
2431       us to close new rendezvous circuits rather than old ones.
2432     - Give a more helpful log message when you try to change ORPort via
2433       the controller: you should upgrade Tor if you want that to work.
2434     - We were failing to parse Tor versions that start with "Tor ".
2435     - Tolerate faulty streams better: when a stream fails for reason
2436       exitpolicy, stop assuming that the router is lying about his exit
2437       policy. When a stream fails for reason misc, allow it to retry just
2438       as if it was resolvefailed. When a stream has failed three times,
2439       reset its failure count so we can try again and get all three tries.
2442 Changes in version 0.1.0.15 - 2005-09-23
2443   o Bugfixes on 0.1.0.x:
2444     - Reject ports 465 and 587 (spam targets) in default exit policy.
2445     - Don't crash when we don't have any spare file descriptors and we
2446       try to spawn a dns or cpu worker.
2447     - Get rid of IgnoreVersion undocumented config option, and make us
2448       only warn, never exit, when we're running an obsolete version.
2449     - Don't try to print a null string when your server finds itself to
2450       be unreachable and the Address config option is empty.
2451     - Make the numbers in read-history and write-history into uint64s,
2452       so they don't overflow and publish negatives in the descriptor.
2453     - Fix a minor memory leak in smartlist_string_remove().
2454     - We were only allowing ourselves to upload a server descriptor at
2455       most every 20 minutes, even if it changed earlier than that.
2456     - Clean up log entries that pointed to old URLs.
2459 Changes in version 0.1.0.14 - 2005-08-08
2460   o Bugfixes on 0.1.0.x:
2461       - Fix the other half of the bug with crypto handshakes
2462         (CVE-2005-2643).
2463       - Fix an assert trigger if you send a 'signal term' via the
2464         controller when it's listening for 'event info' messages.
2467 Changes in version 0.1.0.13 - 2005-08-04
2468   o Bugfixes on 0.1.0.x:
2469     - Fix a critical bug in the security of our crypto handshakes.
2470     - Fix a size_t underflow in smartlist_join_strings2() that made
2471       it do bad things when you hand it an empty smartlist.
2472     - Fix Windows installer to ship Tor license (thanks to Aphex for
2473       pointing out this oversight) and put a link to the doc directory
2474       in the start menu.
2475     - Explicitly set no-unaligned-access for sparc: it turns out the
2476       new gcc's let you compile broken code, but that doesn't make it
2477       not-broken.
2480 Changes in version 0.1.0.12 - 2005-07-18
2481   o New directory servers:
2482       - tor26 has changed IP address.
2484   o Bugfixes on 0.1.0.x:
2485     - Fix a possible double-free in tor_gzip_uncompress().
2486     - When --disable-threads is set, do not search for or link against
2487       pthreads libraries.
2488     - Don't trigger an assert if an authoritative directory server
2489       claims its dirport is 0.
2490     - Fix bug with removing Tor as an NT service: some people were
2491       getting "The service did not return an error." Thanks to Matt
2492       Edman for the fix.
2495 Changes in version 0.1.0.11 - 2005-06-30
2496   o Bugfixes on 0.1.0.x:
2497     - Fix major security bug: servers were disregarding their
2498       exit policies if clients behaved unexpectedly.
2499     - Make OS X init script check for missing argument, so we don't
2500       confuse users who invoke it incorrectly.
2501     - Fix a seg fault in "tor --hash-password foo".
2502     - The MAPADDRESS control command was broken.
2505 Changes in version 0.1.0.10 - 2005-06-14
2506   o Fixes on Win32:
2507     - Make NT services work and start on startup on Win32 (based on
2508       patch by Matt Edman). See the FAQ entry for details.
2509     - Make 'platform' string in descriptor more accurate for Win32
2510       servers, so it's not just "unknown platform".
2511     - REUSEADDR on normal platforms means you can rebind to the port
2512       right after somebody else has let it go. But REUSEADDR on Win32
2513       means you can bind to the port _even when somebody else already
2514       has it bound_! So, don't do that on Win32.
2515     - Clean up the log messages when starting on Win32 with no config
2516       file.
2517     - Allow seeding the RNG on Win32 even when you're not running as
2518       Administrator. If seeding the RNG on Win32 fails, quit.
2520   o Assert / crash bugs:
2521     - Refuse relay cells that claim to have a length larger than the
2522       maximum allowed. This prevents a potential attack that could read
2523       arbitrary memory (e.g. keys) from an exit server's process
2524       (CVE-2005-2050).
2525     - If unofficial Tor clients connect and send weird TLS certs, our
2526       Tor server triggers an assert. Stop asserting, and start handling
2527       TLS errors better in other situations too.
2528     - Fix a race condition that can trigger an assert when we have a
2529       pending create cell and an OR connection attempt fails.
2531   o Resource leaks:
2532     - Use pthreads for worker processes rather than forking. This was
2533       forced because when we forked, we ended up wasting a lot of
2534       duplicate ram over time.
2535       - Also switch to foo_r versions of some library calls to allow
2536         reentry and threadsafeness.
2537       - Implement --disable-threads configure option. Disable threads on
2538         netbsd and openbsd by default, because they have no reentrant
2539         resolver functions (!), and on solaris since it has other
2540         threading issues.
2541     - Fix possible bug on threading platforms (e.g. win32) which was
2542       leaking a file descriptor whenever a cpuworker or dnsworker died.
2543     - Fix a minor memory leak when somebody establishes an introduction
2544       point at your Tor server.
2545     - Fix possible memory leak in tor_lookup_hostname(). (Thanks to
2546       Adam Langley.)
2547     - Add ./configure --with-dmalloc option, to track memory leaks.
2548     - And try to free all memory on closing, so we can detect what
2549       we're leaking.
2551   o Protocol correctness:
2552     - When we've connected to an OR and handshaked but didn't like
2553       the result, we were closing the conn without sending destroy
2554       cells back for pending circuits. Now send those destroys.
2555     - Start sending 'truncated' cells back rather than destroy cells
2556       if the circuit closes in front of you. This means we won't have
2557       to abandon partially built circuits.
2558     - Handle changed router status correctly when dirserver reloads
2559       fingerprint file. We used to be dropping all unverified descriptors
2560       right then. The bug was hidden because we would immediately
2561       fetch a directory from another dirserver, which would include the
2562       descriptors we just dropped.
2563     - Revise tor-spec to add more/better stream end reasons.
2564     - Revise all calls to connection_edge_end to avoid sending 'misc',
2565       and to take errno into account where possible.
2566     - Client now retries when streams end early for 'hibernating' or
2567       'resource limit' reasons, rather than failing them.
2568     - Try to be more zealous about calling connection_edge_end when
2569       things go bad with edge conns in connection.c.
2571   o Robustness improvements:
2572     - Better handling for heterogeneous / unreliable nodes:
2573       - Annotate circuits with whether they aim to contain high uptime
2574         nodes and/or high capacity nodes. When building circuits, choose
2575         appropriate nodes.
2576       - This means that every single node in an intro rend circuit,
2577         not just the last one, will have a minimum uptime.
2578       - New config option LongLivedPorts to indicate application streams
2579         that will want high uptime circuits.
2580       - Servers reset uptime when a dir fetch entirely fails. This
2581         hopefully reflects stability of the server's network connectivity.
2582       - If somebody starts his tor server in Jan 2004 and then fixes his
2583         clock, don't make his published uptime be a year.
2584       - Reset published uptime when we wake up from hibernation.
2585     - Introduce a notion of 'internal' circs, which are chosen without
2586       regard to the exit policy of the last hop. Intro and rendezvous
2587       circs must be internal circs, to avoid leaking information. Resolve
2588       and connect streams can use internal circs if they want.
2589     - New circuit pooling algorithm: keep track of what destination ports
2590       we've used recently (start out assuming we'll want to use 80), and
2591       make sure to have enough circs around to satisfy these ports. Also
2592       make sure to have 2 internal circs around if we've required internal
2593       circs lately (and with high uptime if we've seen that lately too).
2594     - Turn addr_policy_compare from a tristate to a quadstate; this should
2595       help address our "Ah, you allow 1.2.3.4:80. You are a good choice
2596       for google.com" problem.
2597     - When a client asks us for a dir mirror and we don't have one,
2598       launch an attempt to get a fresh one.
2599     - First cut at support for "create-fast" cells. Clients can use
2600       these when extending to their first hop, since the TLS already
2601       provides forward secrecy and authentication. Not enabled on
2602       clients yet.
2604   o Reachability testing.
2605     - Your Tor server will automatically try to see if its ORPort and
2606       DirPort are reachable from the outside, and it won't upload its
2607       descriptor until it decides at least ORPort is reachable (when
2608       DirPort is not yet found reachable, publish it as zero).
2609     - When building testing circs for ORPort testing, use only
2610       high-bandwidth nodes, so fewer circuits fail.
2611     - Notice when our IP changes, and reset stats/uptime/reachability.
2612     - Authdirservers don't do ORPort reachability detection, since
2613       they're in clique mode, so it will be rare to find a server not
2614       already connected to them.
2615     - Authdirservers now automatically approve nodes running 0.1.0.2-rc
2616       or later.
2618   o Dirserver fixes:
2619     - Now we allow two unverified servers with the same nickname
2620       but different keys. But if a nickname is verified, only that
2621       nickname+key are allowed.
2622     - If you're an authdirserver connecting to an address:port,
2623       and it's not the OR you were expecting, forget about that
2624       descriptor. If he *was* the one you were expecting, then forget
2625       about all other descriptors for that address:port.
2626     - Allow servers to publish descriptors from 12 hours in the future.
2627       Corollary: only whine about clock skew from the dirserver if
2628       he's a trusted dirserver (since now even verified servers could
2629       have quite wrong clocks).
2630     - Require servers that use the default dirservers to have public IP
2631       addresses. We have too many servers that are configured with private
2632       IPs and their admins never notice the log entries complaining that
2633       their descriptors are being rejected.
2635   o Efficiency improvements:
2636     - Use libevent. Now we can use faster async cores (like epoll, kpoll,
2637       and /dev/poll), and hopefully work better on Windows too.
2638       - Apple's OS X 10.4.0 ships with a broken kqueue API, and using
2639         kqueue on 10.3.9 causes kernel panics. Don't use kqueue on OS X.
2640       - Find libevent even if it's hiding in /usr/local/ and your
2641         CFLAGS and LDFLAGS don't tell you to look there.
2642       - Be able to link with libevent as a shared library (the default
2643         after 1.0d), even if it's hiding in /usr/local/lib and even
2644         if you haven't added /usr/local/lib to your /etc/ld.so.conf,
2645         assuming you're running gcc. Otherwise fail and give a useful
2646         error message.
2647     - Switch to a new buffer management algorithm, which tries to avoid
2648       reallocing and copying quite as much. In first tests it looks like
2649       it uses *more* memory on average, but less cpu.
2650     - Switch our internal buffers implementation to use a ring buffer,
2651       to hopefully improve performance for fast servers a lot.
2652     - Reenable the part of the code that tries to flush as soon as an
2653       OR outbuf has a full TLS record available. Perhaps this will make
2654       OR outbufs not grow as huge except in rare cases, thus saving lots
2655       of CPU time plus memory.
2656     - Improve performance for dirservers: stop re-parsing the whole
2657       directory every time you regenerate it.
2658     - Keep a big splay tree of (circid,orconn)->circuit mappings to make
2659       it much faster to look up a circuit for each relay cell.
2660     - Remove most calls to assert_all_pending_dns_resolves_ok(),
2661       since they're eating our cpu on exit nodes.
2662     - Stop wasting time doing a case insensitive comparison for every
2663       dns name every time we do any lookup. Canonicalize the names to
2664       lowercase when you first see them.
2666   o Hidden services:
2667     - Handle unavailable hidden services better. Handle slow or busy
2668       hidden services better.
2669     - Cannibalize GENERAL circs to be C_REND, C_INTRO, S_INTRO, and S_REND
2670       circ as necessary, if there are any completed ones lying around
2671       when we try to launch one.
2672     - Make hidden services try to establish a rendezvous for 30 seconds
2673       after fetching the descriptor, rather than for n (where n=3)
2674       attempts to build a circuit.
2675     - Adjust maximum skew and age for rendezvous descriptors: let skew
2676       be 48 hours rather than 90 minutes.
2677     - Reject malformed .onion addresses rather then passing them on as
2678       normal web requests.
2680   o Controller:
2681     - More Tor controller support. See
2682       http://tor.eff.org/doc/control-spec.txt for all the new features,
2683       including signals to emulate unix signals from any platform;
2684       redirectstream; extendcircuit; mapaddress; getinfo; postdescriptor;
2685       closestream; closecircuit; etc.
2686     - Encode hashed controller passwords in hex instead of base64,
2687       to make it easier to write controllers.
2688     - Revise control spec and implementation to allow all log messages to
2689       be sent to controller with their severities intact (suggested by
2690       Matt Edman). Disable debug-level logs while delivering a debug-level
2691       log to the controller, to prevent loop. Update TorControl to handle
2692       new log event types.
2694   o New config options/defaults:
2695     - Begin scrubbing sensitive strings from logs by default. Turn off
2696       the config option SafeLogging if you need to do debugging.
2697     - New exit policy: accept most low-numbered ports, rather than
2698       rejecting most low-numbered ports.
2699     - Put a note in the torrc about abuse potential with the default
2700       exit policy.
2701     - Add support for CONNECTing through https proxies, with "HttpsProxy"
2702       config option.
2703     - Add HttpProxyAuthenticator and HttpsProxyAuthenticator support
2704       based on patch from Adam Langley (basic auth only).
2705     - Bump the default BandwidthRate from 1 MB to 2 MB, to accommodate
2706       the fast servers that have been joining lately. (Clients are now
2707       willing to load balance over up to 2 MB of advertised bandwidth
2708       capacity too.)
2709     - New config option MaxAdvertisedBandwidth which lets you advertise
2710       a low bandwidthrate (to not attract as many circuits) while still
2711       allowing a higher bandwidthrate in reality.
2712     - Require BandwidthRate to be at least 20kB/s for servers.
2713     - Add a NoPublish config option, so you can be a server (e.g. for
2714       testing running Tor servers in other Tor networks) without
2715       publishing your descriptor to the primary dirservers.
2716     - Add a new AddressMap config directive to rewrite incoming socks
2717       addresses. This lets you, for example, declare an implicit
2718       required exit node for certain sites.
2719     - Add a new TrackHostExits config directive to trigger addressmaps
2720       for certain incoming socks addresses -- for sites that break when
2721       your exit keeps changing (based on patch from Mike Perry).
2722     - Split NewCircuitPeriod option into NewCircuitPeriod (30 secs),
2723       which describes how often we retry making new circuits if current
2724       ones are dirty, and MaxCircuitDirtiness (10 mins), which describes
2725       how long we're willing to make use of an already-dirty circuit.
2726     - Change compiled-in SHUTDOWN_WAIT_LENGTH from a fixed 30 secs to
2727       a config option "ShutdownWaitLength" (when using kill -INT on
2728       servers).
2729     - Fix an edge case in parsing config options: if they say "--"
2730       on the commandline, it's not a config option (thanks weasel).
2731     - New config option DirAllowPrivateAddresses for authdirservers.
2732       Now by default they refuse router descriptors that have non-IP or
2733       private-IP addresses.
2734     - Change DirFetchPeriod/StatusFetchPeriod to have a special "Be
2735       smart" default value: low for servers and high for clients.
2736     - Some people were putting "Address  " in their torrc, and they had
2737       a buggy resolver that resolved " " to 0.0.0.0. Oops.
2738     - If DataDir is ~/.tor, and that expands to /.tor, then default to
2739       LOCALSTATEDIR/tor instead.
2740     - Implement --verify-config command-line option to check if your torrc
2741       is valid without actually launching Tor.
2743   o Logging improvements:
2744     - When dirservers refuse a server descriptor, we now log its
2745       contactinfo, platform, and the poster's IP address.
2746     - Only warn once per nickname from add_nickname_list_to_smartlist()
2747       per failure, so an entrynode or exitnode choice that's down won't
2748       yell so much.
2749     - When we're connecting to an OR and he's got a different nickname/key
2750       than we were expecting, only complain loudly if we're an OP or a
2751       dirserver. Complaining loudly to the OR admins just confuses them.
2752     - Whine at you if you're a server and you don't set your contactinfo.
2753     - Warn when exit policy implicitly allows local addresses.
2754     - Give a better warning when some other server advertises an
2755       ORPort that is actually an apache running ssl.
2756     - If we get an incredibly skewed timestamp from a dirserver mirror
2757       that isn't a verified OR, don't warn -- it's probably him that's
2758       wrong.
2759     - When a dirserver causes you to give a warn, mention which dirserver
2760       it was.
2761     - Initialize libevent later in the startup process, so the logs are
2762       already established by the time we start logging libevent warns.
2763     - Use correct errno on win32 if libevent fails.
2764     - Check and warn about known-bad/slow libevent versions.
2765     - Stop warning about sigpipes in the logs. We're going to
2766       pretend that getting these occassionally is normal and fine.
2768   o New contrib scripts:
2769     - New experimental script tor/contrib/exitlist: a simple python
2770       script to parse directories and find Tor nodes that exit to listed
2771       addresses/ports.
2772     - New experimental script tor/contrib/ExerciseServer.py (needs more
2773       work) that uses the controller interface to build circuits and
2774       fetch pages over them. This will help us bootstrap servers that
2775       have lots of capacity but haven't noticed it yet.
2776     - New experimental script tor/contrib/PathDemo.py (needs more work)
2777       that uses the controller interface to let you choose whole paths
2778       via addresses like
2779       "<hostname>.<path,separated by dots>.<length of path>.path"
2780     - New contributed script "privoxy-tor-toggle" to toggle whether
2781       Privoxy uses Tor. Seems to be configured for Debian by default.
2782     - Have torctl.in/tor.sh.in check for location of su binary (needed
2783       on FreeBSD)
2785   o Misc bugfixes:
2786     - chdir() to your datadirectory at the *end* of the daemonize process,
2787       not the beginning. This was a problem because the first time you
2788       run tor, if your datadir isn't there, and you have runasdaemon set
2789       to 1, it will try to chdir to it before it tries to create it. Oops.
2790     - Fix several double-mark-for-close bugs, e.g. where we were finding
2791       a conn for a cell even if that conn is already marked for close.
2792     - Stop most cases of hanging up on a socks connection without sending
2793       the socks reject.
2794     - Fix a bug in the RPM package: set home directory for _tor to
2795       something more reasonable when first installing.
2796     - Stop putting nodename in the Platform string in server descriptors.
2797       It doesn't actually help, and it is confusing/upsetting some people.
2798     - When using preferred entry or exit nodes, ignore whether the
2799       circuit wants uptime or capacity. They asked for the nodes, they
2800       get the nodes.
2801     - Tie MAX_DIR_SIZE to MAX_BUF_SIZE, so now directory sizes won't get
2802       artificially capped at 500kB.
2803     - Cache local dns resolves correctly even when they're .exit
2804       addresses.
2805     - If we're hibernating and we get a SIGINT, exit immediately.
2806     - tor-resolve requests were ignoring .exit if there was a working circuit
2807       they could use instead.
2808     - Pay more attention to the ClientOnly config option.
2809     - Resolve OS X installer bugs: stop claiming to be 0.0.9.2 in certain
2810       installer screens; and don't put stuff into StartupItems unless
2811       the user asks you to.
2813   o Misc features:
2814     - Rewrite address "serifos.exit" to "externalIP.serifos.exit"
2815       rather than just rejecting it.
2816     - If our clock jumps forward by 100 seconds or more, assume something
2817       has gone wrong with our network and abandon all not-yet-used circs.
2818     - When an application is using socks5, give him the whole variety of
2819       potential socks5 responses (connect refused, host unreachable, etc),
2820       rather than just "success" or "failure".
2821     - A more sane version numbering system. See
2822       http://tor.eff.org/cvs/tor/doc/version-spec.txt for details.
2823     - Change version parsing logic: a version is "obsolete" if it is not
2824       recommended and (1) there is a newer recommended version in the
2825       same series, or (2) there are no recommended versions in the same
2826       series, but there are some recommended versions in a newer series.
2827       A version is "new" if it is newer than any recommended version in
2828       the same series.
2829     - Report HTTP reasons to client when getting a response from directory
2830       servers -- so you can actually know what went wrong.
2831     - Reject odd-looking addresses at the client (e.g. addresses that
2832       contain a colon), rather than having the server drop them because
2833       they're malformed.
2834     - Stop publishing socksport in the directory, since it's not
2835       actually meant to be public. For compatibility, publish a 0 there
2836       for now.
2837     - Since we ship our own Privoxy on OS X, tweak it so it doesn't write
2838       cookies to disk and doesn't log each web request to disk. (Thanks
2839       to Brett Carrington for pointing this out.)
2840     - Add OSX uninstall instructions. An actual uninstall script will
2841       come later.
2842     - Add "opt hibernating 1" to server descriptor to make it clearer
2843       whether the server is hibernating.
2846 Changes in version 0.0.9.10 - 2005-06-16
2847   o Bugfixes on 0.0.9.x (backported from 0.1.0.10):
2848     - Refuse relay cells that claim to have a length larger than the
2849       maximum allowed. This prevents a potential attack that could read
2850       arbitrary memory (e.g. keys) from an exit server's process
2851       (CVE-2005-2050).
2854 Changes in version 0.0.9.9 - 2005-04-23
2855   o Bugfixes on 0.0.9.x:
2856     - If unofficial Tor clients connect and send weird TLS certs, our
2857       Tor server triggers an assert. This release contains a minimal
2858       backport from the broader fix that we put into 0.1.0.4-rc.
2861 Changes in version 0.0.9.8 - 2005-04-07
2862   o Bugfixes on 0.0.9.x:
2863     - We have a bug that I haven't found yet. Sometimes, very rarely,
2864       cpuworkers get stuck in the 'busy' state, even though the cpuworker
2865       thinks of itself as idle. This meant that no new circuits ever got
2866       established. Here's a workaround to kill any cpuworker that's been
2867       busy for more than 100 seconds.
2870 Changes in version 0.0.9.7 - 2005-04-01
2871   o Bugfixes on 0.0.9.x:
2872     - Fix another race crash bug (thanks to Glenn Fink for reporting).
2873     - Compare identity to identity, not to nickname, when extending to
2874       a router not already in the directory. This was preventing us from
2875       extending to unknown routers. Oops.
2876     - Make sure to create OS X Tor user in <500 range, so we aren't
2877       creating actual system users.
2878     - Note where connection-that-hasn't-sent-end was marked, and fix
2879       a few really loud instances of this harmless bug (it's fixed more
2880       in 0.1.0.x).
2883 Changes in version 0.0.9.6 - 2005-03-24
2884   o Bugfixes on 0.0.9.x (crashes and asserts):
2885     - Add new end stream reasons to maintainance branch. Fix bug where
2886       reason (8) could trigger an assert.  Prevent bug from recurring.
2887     - Apparently win32 stat wants paths to not end with a slash.
2888     - Fix assert triggers in assert_cpath_layer_ok(), where we were
2889       blowing away the circuit that conn->cpath_layer points to, then
2890       checking to see if the circ is well-formed. Backport check to make
2891       sure we dont use the cpath on a closed connection.
2892     - Prevent circuit_resume_edge_reading_helper() from trying to package
2893       inbufs for marked-for-close streams.
2894     - Don't crash on hup if your options->address has become unresolvable.
2895     - Some systems (like OS X) sometimes accept() a connection and tell
2896       you the remote host is 0.0.0.0:0. If this happens, due to some
2897       other mis-features, we get confused; so refuse the conn for now.
2899   o Bugfixes on 0.0.9.x (other):
2900     - Fix harmless but scary "Unrecognized content encoding" warn message.
2901     - Add new stream error reason: TORPROTOCOL reason means "you are not
2902       speaking a version of Tor I understand; say bye-bye to your stream."
2903     - Be willing to cache directories from up to ROUTER_MAX_AGE seconds
2904       into the future, now that we are more tolerant of skew. This
2905       resolves a bug where a Tor server would refuse to cache a directory
2906       because all the directories it gets are too far in the future;
2907       yet the Tor server never logs any complaints about clock skew.
2908     - Mac packaging magic: make man pages useable, and do not overwrite
2909       existing torrc files.
2910     - Make OS X log happily to /var/log/tor/tor.log
2913 Changes in version 0.0.9.5 - 2005-02-22
2914   o Bugfixes on 0.0.9.x:
2915     - Fix an assert race at exit nodes when resolve requests fail.
2916     - Stop picking unverified dir mirrors--it only leads to misery.
2917     - Patch from Matt Edman to make NT services work better. Service
2918       support is still not compiled into the executable by default.
2919     - Patch from Dmitri Bely so the Tor service runs better under
2920       the win32 SYSTEM account.
2921     - Make tor-resolve actually work (?) on Win32.
2922     - Fix a sign bug when getrlimit claims to have 4+ billion
2923       file descriptors available.
2924     - Stop refusing to start when bandwidthburst == bandwidthrate.
2925     - When create cells have been on the onion queue more than five
2926       seconds, just send back a destroy and take them off the list.
2929 Changes in version 0.0.9.4 - 2005-02-03
2930   o Bugfixes on 0.0.9:
2931     - Fix an assert bug that took down most of our servers: when
2932       a server claims to have 1 GB of bandwidthburst, don't
2933       freak out.
2934     - Don't crash as badly if we have spawned the max allowed number
2935       of dnsworkers, or we're out of file descriptors.
2936     - Block more file-sharing ports in the default exit policy.
2937     - MaxConn is now automatically set to the hard limit of max
2938       file descriptors we're allowed (ulimit -n), minus a few for
2939       logs, etc.
2940     - Give a clearer message when servers need to raise their
2941       ulimit -n when they start running out of file descriptors.
2942     - SGI Compatibility patches from Jan Schaumann.
2943     - Tolerate a corrupt cached directory better.
2944     - When a dirserver hasn't approved your server, list which one.
2945     - Go into soft hibernation after 95% of the bandwidth is used,
2946       not 99%. This is especially important for daily hibernators who
2947       have a small accounting max. Hopefully it will result in fewer
2948       cut connections when the hard hibernation starts.
2949     - Load-balance better when using servers that claim more than
2950       800kB/s of capacity.
2951     - Make NT services work (experimental, only used if compiled in).
2954 Changes in version 0.0.9.3 - 2005-01-21
2955   o Bugfixes on 0.0.9:
2956     - Backport the cpu use fixes from main branch, so busy servers won't
2957       need as much processor time.
2958     - Work better when we go offline and then come back, or when we
2959       run Tor at boot before the network is up. We do this by
2960       optimistically trying to fetch a new directory whenever an
2961       application request comes in and we think we're offline -- the
2962       human is hopefully a good measure of when the network is back.
2963     - Backport some minimal hidserv bugfixes: keep rend circuits open as
2964       long as you keep using them; actually publish hidserv descriptors
2965       shortly after they change, rather than waiting 20-40 minutes.
2966     - Enable Mac startup script by default.
2967     - Fix duplicate dns_cancel_pending_resolve reported by Giorgos Pallas.
2968     - When you update AllowUnverifiedNodes or FirewallPorts via the
2969       controller's setconf feature, we were always appending, never
2970       resetting.
2971     - When you update HiddenServiceDir via setconf, it was screwing up
2972       the order of reading the lines, making it fail.
2973     - Do not rewrite a cached directory back to the cache; otherwise we
2974       will think it is recent and not fetch a newer one on startup.
2975     - Workaround for webservers that lie about Content-Encoding: Tor
2976       now tries to autodetect compressed directories and compression
2977       itself. This lets us Proxypass dir fetches through apache.
2980 Changes in version 0.0.9.2 - 2005-01-04
2981   o Bugfixes on 0.0.9 (crashes and asserts):
2982     - Fix an assert on startup when the disk is full and you're logging
2983       to a file.
2984     - If you do socks4 with an IP of 0.0.0.x but *don't* provide a socks4a
2985       style address, then we'd crash.
2986     - Fix an assert trigger when the running-routers string we get from
2987       a dirserver is broken.
2988     - Make worker threads start and run on win32. Now win32 servers
2989       may work better.
2990     - Bandaid (not actually fix, but now it doesn't crash) an assert
2991       where the dns worker dies mysteriously and the main Tor process
2992       doesn't remember anything about the address it was resolving.
2994   o Bugfixes on 0.0.9 (Win32):
2995     - Workaround for brain-damaged __FILE__ handling on MSVC: keep Nick's
2996       name out of the warning/assert messages.
2997     - Fix a superficial "unhandled error on read" bug on win32.
2998     - The win32 installer no longer requires a click-through for our
2999       license, since our Free Software license grants rights but does not
3000       take any away.
3001     - Win32: When connecting to a dirserver fails, try another one
3002       immediately. (This was already working for non-win32 Tors.)
3003     - Stop trying to parse $HOME on win32 when hunting for default
3004       DataDirectory.
3005     - Make tor-resolve.c work on win32 by calling network_init().
3007   o Bugfixes on 0.0.9 (other):
3008     - Make 0.0.9.x build on Solaris again.
3009     - Due to a fencepost error, we were blowing away the \n when reporting
3010       confvalue items in the controller. So asking for multiple config
3011       values at once couldn't work.
3012     - When listing circuits that are pending on an opening OR connection,
3013       if we're an OR we were listing circuits that *end* at us as
3014       being pending on every listener, dns/cpu worker, etc. Stop that.
3015     - Dirservers were failing to create 'running-routers' or 'directory'
3016       strings if we had more than some threshold of routers. Fix them so
3017       they can handle any number of routers.
3018     - Fix a superficial "Duplicate mark for close" bug.
3019     - Stop checking for clock skew for OR connections, even for servers.
3020     - Fix a fencepost error that was chopping off the last letter of any
3021       nickname that is the maximum allowed nickname length.
3022     - Update URLs in log messages so they point to the new website.
3023     - Fix a potential problem in mangling server private keys while
3024       writing to disk (not triggered yet, as far as we know).
3025     - Include the licenses for other free software we include in Tor,
3026       now that we're shipping binary distributions more regularly.
3029 Changes in version 0.0.9.1 - 2004-12-15
3030   o Bugfixes on 0.0.9:
3031     - Make hibernation actually work.
3032     - Make HashedControlPassword config option work.
3033     - When we're reporting event circuit status to a controller,
3034       don't use the stream status code.
3037 Changes in version 0.0.9 - 2004-12-12
3038   o Bugfixes on 0.0.8.1 (Crashes and asserts):
3039     - Catch and ignore SIGXFSZ signals when log files exceed 2GB; our
3040       write() call will fail and we handle it there.
3041     - When we run out of disk space, or other log writing error, don't
3042       crash. Just stop logging to that log and continue.
3043     - Fix isspace() and friends so they still make Solaris happy
3044       but also so they don't trigger asserts on win32.
3045     - Fix assert failure on malformed socks4a requests.
3046     - Fix an assert bug where a hidden service provider would fail if
3047       the first hop of his rendezvous circuit was down.
3048     - Better handling of size_t vs int, so we're more robust on 64
3049       bit platforms.
3051   o Bugfixes on 0.0.8.1 (Win32):
3052     - Make windows sockets actually non-blocking (oops), and handle
3053       win32 socket errors better.
3054     - Fix parse_iso_time on platforms without strptime (eg win32).
3055     - win32: when being multithreaded, leave parent fdarray open.
3056     - Better handling of winsock includes on non-MSV win32 compilers.
3057     - Change our file IO stuff (especially wrt OpenSSL) so win32 is
3058       happier.
3059     - Make unit tests work on win32.
3061   o Bugfixes on 0.0.8.1 (Path selection and streams):
3062     - Calculate timeout for waiting for a connected cell from the time
3063       we sent the begin cell, not from the time the stream started. If
3064       it took a long time to establish the circuit, we would time out
3065       right after sending the begin cell.
3066     - Fix router_compare_addr_to_addr_policy: it was not treating a port
3067       of * as always matching, so we were picking reject *:* nodes as
3068       exit nodes too. Oops.
3069     - When read() failed on a stream, we would close it without sending
3070       back an end. So 'connection refused' would simply be ignored and
3071       the user would get no response.
3072     - Stop a sigpipe: when an 'end' cell races with eof from the app,
3073       we shouldn't hold-open-until-flush if the eof arrived first.
3074     - Let resolve conns retry/expire also, rather than sticking around
3075       forever.
3076     - Fix more dns related bugs: send back resolve_failed and end cells
3077       more reliably when the resolve fails, rather than closing the
3078       circuit and then trying to send the cell. Also attach dummy resolve
3079       connections to a circuit *before* calling dns_resolve(), to fix
3080       a bug where cached answers would never be sent in RESOLVED cells.
3082   o Bugfixes on 0.0.8.1 (Circuits):
3083     - Finally fix a bug that's been plaguing us for a year:
3084       With high load, circuit package window was reaching 0. Whenever
3085       we got a circuit-level sendme, we were reading a lot on each
3086       socket, but only writing out a bit. So we would eventually reach
3087       eof. This would be noticed and acted on even when there were still
3088       bytes sitting in the inbuf.
3089     - Use identity comparison, not nickname comparison, to choose which
3090       half of circuit-ID-space each side gets to use. This is needed
3091       because sometimes we think of a router as a nickname, and sometimes
3092       as a hex ID, and we can't predict what the other side will do.
3094   o Bugfixes on 0.0.8.1 (Other):
3095     - Fix a whole slew of memory leaks.
3096     - Disallow NDEBUG. We don't ever want anybody to turn off debug.
3097     - If we are using select, make sure we stay within FD_SETSIZE.
3098     - When poll() is interrupted, we shouldn't believe the revents values.
3099     - Add a FAST_SMARTLIST define to optionally inline smartlist_get
3100       and smartlist_len, which are two major profiling offenders.
3101     - If do_hup fails, actually notice.
3102     - Flush the log file descriptor after we print "Tor opening log file",
3103       so we don't see those messages days later.
3104     - Hidden service operators now correctly handle version 1 style
3105       INTRODUCE1 cells (nobody generates them still, so not a critical
3106       bug).
3107     - Handle more errnos from accept() without closing the listener.
3108       Some OpenBSD machines were closing their listeners because
3109       they ran out of file descriptors.
3110     - Some people had wrapped their tor client/server in a script
3111       that would restart it whenever it died. This did not play well
3112       with our "shut down if your version is obsolete" code. Now people
3113       don't fetch a new directory if their local cached version is
3114       recent enough.
3115     - Make our autogen.sh work on ksh as well as bash.
3116     - Better torrc example lines for dirbindaddress and orbindaddress.
3117     - Improved bounds checking on parsed ints (e.g. config options and
3118       the ones we find in directories.)
3119     - Stop using separate defaults for no-config-file and
3120       empty-config-file. Now you have to explicitly turn off SocksPort,
3121       if you don't want it open.
3122     - We were starting to daemonize before we opened our logs, so if
3123       there were any problems opening logs, we would complain to stderr,
3124       which wouldn't work, and then mysteriously exit.
3125     - If a verified OR connects to us before he's uploaded his descriptor,
3126       or we verify him and hup but he still has the original TLS
3127       connection, then conn->nickname is still set like he's unverified.
3129   o Code security improvements, inspired by Ilja:
3130     - tor_snprintf wrapper over snprintf with consistent (though not C99)
3131       overflow behavior.
3132     - Replace sprintf with tor_snprintf. (I think they were all safe, but
3133       hey.)
3134     - Replace strcpy/strncpy with strlcpy in more places.
3135     - Avoid strcat; use tor_snprintf or strlcat instead.
3137   o Features (circuits and streams):
3138     - New circuit building strategy: keep a list of ports that we've
3139       used in the past 6 hours, and always try to have 2 circuits open
3140       or on the way that will handle each such port. Seed us with port
3141       80 so web users won't complain that Tor is "slow to start up".
3142     - Make kill -USR1 dump more useful stats about circuits.
3143     - When warning about retrying or giving up, print the address, so
3144       the user knows which one it's talking about.
3145     - If you haven't used a clean circuit in an hour, throw it away,
3146       just to be on the safe side. (This means after 6 hours a totally
3147       unused Tor client will have no circuits open.)
3148     - Support "foo.nickname.exit" addresses, to let Alice request the
3149       address "foo" as viewed by exit node "nickname". Based on a patch
3150       from Geoff Goodell.
3151     - If your requested entry or exit node has advertised bandwidth 0,
3152       pick it anyway.
3153     - Be more greedy about filling up relay cells -- we try reading again
3154       once we've processed the stuff we read, in case enough has arrived
3155       to fill the last cell completely.
3156     - Refuse application socks connections to port 0.
3157     - Use only 0.0.9pre1 and later servers for resolve cells.
3159   o Features (bandwidth):
3160     - Hibernation: New config option "AccountingMax" lets you
3161       set how many bytes per month (in each direction) you want to
3162       allow your server to consume. Rather than spreading those
3163       bytes out evenly over the month, we instead hibernate for some
3164       of the month and pop up at a deterministic time, work until
3165       the bytes are consumed, then hibernate again. Config option
3166       "MonthlyAccountingStart" lets you specify which day of the month
3167       your billing cycle starts on.
3168     - Implement weekly/monthly/daily accounting: now you specify your
3169       hibernation properties by
3170       AccountingMax N bytes|KB|MB|GB|TB
3171       AccountingStart day|week|month [day] HH:MM
3172         Defaults to "month 1 0:00".
3173     - Let bandwidth and interval config options be specified as 5 bytes,
3174       kb, kilobytes, etc; and as seconds, minutes, hours, days, weeks.
3176   o Features (directories):
3177     - New "router-status" line in directory, to better bind each verified
3178       nickname to its identity key.
3179     - Clients can ask dirservers for /dir.z to get a compressed version
3180       of the directory. Only works for servers running 0.0.9, of course.
3181     - Make clients cache directories and use them to seed their router
3182       lists at startup. This means clients have a datadir again.
3183     - Respond to content-encoding headers by trying to uncompress as
3184       appropriate.
3185     - Clients and servers now fetch running-routers; cache
3186       running-routers; compress running-routers; serve compressed
3187       running-routers.z
3188     - Make moria2 advertise a dirport of 80, so people behind firewalls
3189       will be able to get a directory.
3190     - Http proxy support
3191       - Dirservers translate requests for http://%s:%d/x to /x
3192       - You can specify "HttpProxy %s[:%d]" and all dir fetches will
3193         be routed through this host.
3194       - Clients ask for /tor/x rather than /x for new enough dirservers.
3195         This way we can one day coexist peacefully with apache.
3196       - Clients specify a "Host: %s%d" http header, to be compatible
3197         with more proxies, and so running squid on an exit node can work.
3198     - Protect dirservers from overzealous descriptor uploading -- wait
3199       10 seconds after directory gets dirty, before regenerating.
3201   o Features (packages and install):
3202     - Add NSI installer contributed by J Doe.
3203     - Apply NT service patch from Osamu Fujino. Still needs more work.
3204     - Commit VC6 and VC7 workspace/project files.
3205     - Commit a tor.spec for making RPM files, with help from jbash.
3206     - Add contrib/torctl.in contributed by Glenn Fink.
3207     - Make expand_filename handle ~ and ~username.
3208     - Use autoconf to enable largefile support where necessary. Use
3209       ftello where available, since ftell can fail at 2GB.
3210     - Ship src/win32/ in the tarball, so people can use it to build.
3211     - Make old win32 fall back to CWD if SHGetSpecialFolderLocation
3212       is broken.
3214   o Features (ui controller):
3215     - Control interface: a separate program can now talk to your
3216       client/server over a socket, and get/set config options, receive
3217       notifications of circuits and streams starting/finishing/dying,
3218       bandwidth used, etc. The next step is to get some GUIs working.
3219       Let us know if you want to help out. See doc/control-spec.txt .
3220     - Ship a contrib/tor-control.py as an example script to interact
3221       with the control port.
3222     - "tor --hash-password zzyxz" will output a salted password for
3223       use in authenticating to the control interface.
3224     - Implement the control-spec's SAVECONF command, to write your
3225       configuration to torrc.
3226     - Get cookie authentication for the controller closer to working.
3227     - When set_conf changes our server descriptor, upload a new copy.
3228       But don't upload it too often if there are frequent changes.
3230   o Features (config and command-line):
3231     - Deprecate unofficial config option abbreviations, and abbreviations
3232       not on the command line.
3233     - Configuration infrastructure support for warning on obsolete
3234       options.
3235     - Give a slightly more useful output for "tor -h".
3236     - Break DirFetchPostPeriod into:
3237       - DirFetchPeriod for fetching full directory,
3238       - StatusFetchPeriod for fetching running-routers,
3239       - DirPostPeriod for posting server descriptor,
3240       - RendPostPeriod for posting hidden service descriptors.
3241     - New log format in config:
3242       "Log minsev[-maxsev] stdout|stderr|syslog" or
3243       "Log minsev[-maxsev] file /var/foo"
3244     - DirPolicy config option, to let people reject incoming addresses
3245       from their dirserver.
3246     - "tor --list-fingerprint" will list your identity key fingerprint
3247       and then exit.
3248     - Make tor --version --version dump the cvs Id of every file.
3249     - New 'MyFamily nick1,...' config option for a server to
3250       specify other servers that shouldn't be used in the same circuit
3251       with it. Only believed if nick1 also specifies us.
3252     - New 'NodeFamily nick1,nick2,...' config option for a client to
3253       specify nodes that it doesn't want to use in the same circuit.
3254     - New 'Redirectexit pattern address:port' config option for a
3255       server to redirect exit connections, e.g. to a local squid.
3256     - Add "pass" target for RedirectExit, to make it easier to break
3257       out of a sequence of RedirectExit rules.
3258     - Make the dirservers file obsolete.
3259       - Include a dir-signing-key token in directories to tell the
3260         parsing entity which key is being used to sign.
3261       - Remove the built-in bulky default dirservers string.
3262       - New config option "Dirserver %s:%d [fingerprint]", which can be
3263         repeated as many times as needed. If no dirservers specified,
3264         default to moria1,moria2,tor26.
3265       - Make 'Routerfile' config option obsolete.
3266     - Discourage people from setting their dirfetchpostperiod more often
3267       than once per minute.
3269   o Features (other):
3270     - kill -USR2 now moves all logs to loglevel debug (kill -HUP to
3271       get back to normal.)
3272     - Accept *:706 (silc) in default exit policy.
3273     - Implement new versioning format for post 0.1.
3274     - Distinguish between TOR_TLS_CLOSE and TOR_TLS_ERROR, so we can
3275       log more informatively.
3276     - Check clock skew for verified servers, but allow unverified
3277       servers and clients to have any clock skew.
3278     - Make sure the hidden service descriptors are at a random offset
3279       from each other, to hinder linkability.
3280     - Clients now generate a TLS cert too, in preparation for having
3281       them act more like real nodes.
3282     - Add a pure-C tor-resolve implementation.
3283     - Use getrlimit and friends to ensure we can reach MaxConn (currently
3284       1024) file descriptors.
3285     - Raise the max dns workers from 50 to 100.
3288 Changes in version 0.0.8.1 - 2004-10-13
3289   o Bugfixes:
3290     - Fix a seg fault that can be triggered remotely for Tor
3291       clients/servers with an open dirport.
3292     - Fix a rare assert trigger, where routerinfos for entries in
3293       our cpath would expire while we're building the path.
3294     - Fix a bug in OutboundBindAddress so it (hopefully) works.
3295     - Fix a rare seg fault for people running hidden services on
3296       intermittent connections.
3297     - Fix a bug in parsing opt keywords with objects.
3298     - Fix a stale pointer assert bug when a stream detaches and
3299       reattaches.
3300     - Fix a string format vulnerability (probably not exploitable)
3301       in reporting stats locally.
3302     - Fix an assert trigger: sometimes launching circuits can fail
3303       immediately, e.g. because too many circuits have failed recently.
3304     - Fix a compile warning on 64 bit platforms.
3307 Changes in version 0.0.8 - 2004-08-25
3308   o Bugfixes:
3309     - Made our unit tests compile again on OpenBSD 3.5, and tor
3310       itself compile again on OpenBSD on a sparc64.
3311     - We were neglecting milliseconds when logging on win32, so
3312       everything appeared to happen at the beginning of each second.
3313     - Check directory signature _before_ you decide whether you're
3314       you're running an obsolete version and should exit.
3315     - Check directory signature _before_ you parse the running-routers
3316       list to decide who's running.
3317     - Check return value of fclose while writing to disk, so we don't
3318       end up with broken files when servers run out of disk space.
3319     - Port it to SunOS 5.9 / Athena
3320     - Fix two bugs in saving onion keys to disk when rotating, so
3321       hopefully we'll get fewer people using old onion keys.
3322     - Remove our mostly unused -- and broken -- hex_encode()
3323       function. Use base16_encode() instead. (Thanks to Timo Lindfors
3324       for pointing out this bug.)
3325     - Only pick and establish intro points after we've gotten a
3326       directory.
3327     - Fix assert triggers: if the other side returns an address 0.0.0.0,
3328       don't put it into the client dns cache.
3329     - If a begin failed due to exit policy, but we believe the IP
3330       address should have been allowed, switch that router to exitpolicy
3331       reject *:* until we get our next directory.
3333   o Protocol changes:
3334     - 'Extend' relay cell payloads now include the digest of the
3335       intended next hop's identity key. Now we can verify that we're
3336       extending to the right router, and also extend to routers we
3337       hadn't heard of before.
3339   o Features:
3340     - Tor nodes can now act as relays (with an advertised ORPort)
3341       without being manually verified by the dirserver operators.
3342       - Uploaded descriptors of unverified routers are now accepted
3343         by the dirservers, and included in the directory.
3344       - Verified routers are listed by nickname in the running-routers
3345         list; unverified routers are listed as "$<fingerprint>".
3346       - We now use hash-of-identity-key in most places rather than
3347         nickname or addr:port, for improved security/flexibility.
3348       - AllowUnverifiedNodes config option to let circuits choose no-name
3349         routers in entry,middle,exit,introduction,rendezvous positions.
3350         Allow middle and rendezvous positions by default.
3351       - When picking unverified routers, skip those with low uptime and/or
3352         low bandwidth, depending on what properties you care about.
3353       - ClientOnly option for nodes that never want to become servers.
3354     - Directory caching.
3355       - "AuthoritativeDir 1" option for the official dirservers.
3356       - Now other nodes (clients and servers) will cache the latest
3357         directory they've pulled down.
3358       - They can enable their DirPort to serve it to others.
3359       - Clients will pull down a directory from any node with an open
3360         DirPort, and check the signature/timestamp correctly.
3361       - Authoritative dirservers now fetch directories from other
3362         authdirservers, to stay better synced.
3363       - Running-routers list tells who's down also, along with noting
3364         if they're verified (listed by nickname) or unverified (listed
3365         by hash-of-key).
3366       - Allow dirservers to serve running-router list separately.
3367         This isn't used yet.
3368       - You can now fetch $DIRURL/running-routers to get just the
3369         running-routers line, not the whole descriptor list. (But
3370         clients don't use this yet.)
3371     - Clients choose nodes proportional to advertised bandwidth.
3372     - Clients avoid using nodes with low uptime as introduction points.
3373     - Handle servers with dynamic IP addresses: don't just replace
3374       options->Address with the resolved one at startup, and
3375       detect our address right before we make a routerinfo each time.
3376     - 'FascistFirewall' option to pick dirservers and ORs on specific
3377       ports; plus 'FirewallPorts' config option to tell FascistFirewall
3378       which ports are open. (Defaults to 80,443)
3379     - Try other dirservers immediately if the one you try is down. This
3380       should tolerate down dirservers better now.
3381     - ORs connect-on-demand to other ORs
3382       - If you get an extend cell to an OR you're not connected to,
3383         connect, handshake, and forward the create cell.
3384       - The authoritative dirservers stay connected to everybody,
3385         and everybody stays connected to 0.0.7 servers, but otherwise
3386         clients/servers expire unused connections after 5 minutes.
3387     - When servers get a sigint, they delay 30 seconds (refusing new
3388       connections) then exit. A second sigint causes immediate exit.
3389     - File and name management:
3390       - Look for .torrc if no CONFDIR "torrc" is found.
3391       - If no datadir is defined, then choose, make, and secure ~/.tor
3392         as datadir.
3393       - If torrc not found, exitpolicy reject *:*.
3394       - Expands ~/ in filenames to $HOME/ (but doesn't yet expand ~arma).
3395       - If no nickname is defined, derive default from hostname.
3396       - Rename secret key files, e.g. identity.key -> secret_id_key,
3397         to discourage people from mailing their identity key to tor-ops.
3398     - Refuse to build a circuit before the directory has arrived --
3399       it won't work anyway, since you won't know the right onion keys
3400       to use.
3401     - Parse tor version numbers so we can do an is-newer-than check
3402       rather than an is-in-the-list check.
3403     - New socks command 'resolve', to let us shim gethostbyname()
3404       locally.
3405       - A 'tor_resolve' script to access the socks resolve functionality.
3406       - A new socks-extensions.txt doc file to describe our
3407         interpretation and extensions to the socks protocols.
3408     - Add a ContactInfo option, which gets published in descriptor.
3409     - Write tor version at the top of each log file
3410     - New docs in the tarball:
3411       - tor-doc.html.
3412       - Document that you should proxy your SSL traffic too.
3413     - Log a warning if the user uses an unsafe socks variant, so people
3414       are more likely to learn about privoxy or socat.
3415     - Log a warning if you're running an unverified server, to let you
3416       know you might want to get it verified.
3417     - Change the default exit policy to reject the default edonkey,
3418       kazaa, gnutella ports.
3419     - Add replace_file() to util.[ch] to handle win32's rename().
3420     - Publish OR uptime in descriptor (and thus in directory) too.
3421     - Remember used bandwidth (both in and out), and publish 15-minute
3422       snapshots for the past day into our descriptor.
3423     - Be more aggressive about trying to make circuits when the network
3424       has changed (e.g. when you unsuspend your laptop).
3425     - Check for time skew on http headers; report date in response to
3426       "GET /".
3427     - If the entrynode config line has only one node, don't pick it as
3428       an exitnode.
3429     - Add strict{entry|exit}nodes config options. If set to 1, then
3430       we refuse to build circuits that don't include the specified entry
3431       or exit nodes.
3432     - OutboundBindAddress config option, to bind to a specific
3433       IP address for outgoing connect()s.
3434     - End truncated log entries (e.g. directories) with "[truncated]".
3437 Changes in version 0.0.7.3 - 2004-08-12
3438   o Stop dnsworkers from triggering an assert failure when you
3439     ask them to resolve the host "".
3442 Changes in version 0.0.7.2 - 2004-07-07
3443   o A better fix for the 0.0.0.0 problem, that will hopefully
3444     eliminate the remaining related assertion failures.
3447 Changes in version 0.0.7.1 - 2004-07-04
3448   o When an address resolves to 0.0.0.0, treat it as a failed resolve,
3449     since internally we use 0.0.0.0 to signify "not yet resolved".
3452 Changes in version 0.0.7 - 2004-06-07
3453   o Fixes for crashes and other obnoxious bugs:
3454     - Fix an epipe bug: sometimes when directory connections failed
3455       to connect, we would give them a chance to flush before closing
3456       them.
3457     - When we detached from a circuit because of resolvefailed, we
3458       would immediately try the same circuit twice more, and then
3459       give up on the resolve thinking we'd tried three different
3460       exit nodes.
3461     - Limit the number of intro circuits we'll attempt to build for a
3462       hidden service per 15-minute period.
3463     - Check recommended-software string *early*, before actually parsing
3464       the directory. Thus we can detect an obsolete version and exit,
3465       even if the new directory format doesn't parse.
3466   o Fixes for security bugs:
3467     - Remember which nodes are dirservers when you startup, and if a
3468       random OR enables his dirport, don't automatically assume he's
3469       a trusted dirserver.
3470   o Other bugfixes:
3471     - Directory connections were asking the wrong poll socket to
3472       start writing, and not asking themselves to start writing.
3473     - When we detached from a circuit because we sent a begin but
3474       didn't get a connected, we would use it again the first time;
3475       but after that we would correctly switch to a different one.
3476     - Stop warning when the first onion decrypt attempt fails; they
3477       will sometimes legitimately fail now that we rotate keys.
3478     - Override unaligned-access-ok check when $host_cpu is ia64 or
3479       arm. Apparently they allow it but the kernel whines.
3480     - Dirservers try to reconnect periodically too, in case connections
3481       have failed.
3482     - Fix some memory leaks in directory servers.
3483     - Allow backslash in Win32 filenames.
3484     - Made Tor build complain-free on FreeBSD, hopefully without
3485       breaking other BSD builds. We'll see.
3486     - Check directory signatures based on name of signer, not on whom
3487       we got the directory from. This will let us cache directories more
3488       easily.
3489     - Rotate dnsworkers and cpuworkers on SIGHUP, so they get new config
3490       settings too.
3491   o Features:
3492     - Doxygen markup on all functions and global variables.
3493     - Make directory functions update routerlist, not replace it. So
3494       now directory disagreements are not so critical a problem.
3495     - Remove the upper limit on number of descriptors in a dirserver's
3496       directory (not that we were anywhere close).
3497     - Allow multiple logfiles at different severity ranges.
3498     - Allow *BindAddress to specify ":port" rather than setting *Port
3499       separately. Allow multiple instances of each BindAddress config
3500       option, so you can bind to multiple interfaces if you want.
3501     - Allow multiple exit policy lines, which are processed in order.
3502       Now we don't need that huge line with all the commas in it.
3503     - Enable accept/reject policies on SOCKS connections, so you can bind
3504       to 0.0.0.0 but still control who can use your OP.
3505     - Updated the man page to reflect these features.
3508 Changes in version 0.0.6.2 - 2004-05-16
3509   o Our integrity-checking digest was checking only the most recent cell,
3510     not the previous cells like we'd thought.
3511     Thanks to Stefan Mark for finding the flaw!
3514 Changes in version 0.0.6.1 - 2004-05-06
3515   o Fix two bugs in our AES counter-mode implementation (this affected
3516     onion-level stream encryption, but not TLS-level). It turns
3517     out we were doing something much more akin to a 16-character
3518     polyalphabetic cipher. Oops.
3519     Thanks to Stefan Mark for finding the flaw!
3520   o Retire moria3 as a directory server, and add tor26 as a directory
3521     server.
3524 Changes in version 0.0.6 - 2004-05-02
3525   o Features:
3526     - Hidden services and rendezvous points are implemented. Go to
3527       http://6sxoyfb3h2nvok2d.onion/ for an index of currently available
3528       hidden services. (This only works via a socks4a proxy such as
3529       Privoxy, and currently it's quite slow.)
3530     - We now rotate link (tls context) keys and onion keys.
3531     - CREATE cells now include oaep padding, so you can tell
3532       if you decrypted them correctly.
3533     - Retry stream correctly when we fail to connect because of
3534       exit-policy-reject (should try another) or can't-resolve-address.
3535     - When we hup a dirserver and we've *removed* a server from the
3536       approved-routers list, now we remove that server from the
3537       in-memory directories too.
3538     - Add bandwidthburst to server descriptor.
3539     - Directories now say which dirserver signed them.
3540     - Use a tor_assert macro that logs failed assertions too.
3541     - Since we don't support truncateds much, don't bother sending them;
3542       just close the circ.
3543     - Fetch randomness from /dev/urandom better (not via fopen/fread)
3544     - Better debugging for tls errors
3545     - Set Content-Type on the directory and hidserv descriptor.
3546     - Remove IVs from cipher code, since AES-ctr has none.
3547   o Bugfixes:
3548     - Fix an assert trigger for exit nodes that's been plaguing us since
3549       the days of 0.0.2prexx (thanks weasel!)
3550     - Fix a bug where we were closing tls connections intermittently.
3551       It turns out openssl keeps its errors around -- so if an error
3552       happens, and you don't ask about it, and then another openssl
3553       operation happens and succeeds, and you ask if there was an error,
3554       it tells you about the first error.
3555     - Fix a bug that's been lurking since 27 may 03 (!)
3556       When passing back a destroy cell, we would use the wrong circ id.
3557     - Don't crash if a conn that sent a begin has suddenly lost its circuit.
3558     - Some versions of openssl have an SSL_pending function that erroneously
3559       returns bytes when there is a non-application record pending.
3560     - Win32 fixes. Tor now compiles on win32 with no warnings/errors.
3561       o We were using an array of length zero in a few places.
3562       o Win32's gethostbyname can't resolve an IP to an IP.
3563       o Win32's close can't close a socket.
3564       o Handle windows socket errors correctly.
3565   o Portability:
3566     - check for <sys/limits.h> so we build on FreeBSD again, and
3567       <machine/limits.h> for NetBSD.
3570 Changes in version 0.0.5 - 2004-03-30
3571   o Install torrc as torrc.sample -- we no longer clobber your
3572     torrc. (Woo!)
3573   o Fix mangled-state bug in directory fetching (was causing sigpipes).
3574   o Only build circuits after we've fetched the directory: clients were
3575     using only the directory servers before they'd fetched a directory.
3576     This also means longer startup time; so it goes.
3577   o Fix an assert trigger where an OP would fail to handshake, and we'd
3578     expect it to have a nickname.
3579   o Work around a tsocks bug: do a socks reject when AP connection dies
3580     early, else tsocks goes into an infinite loop.
3581   o Hold socks connection open until reply is flushed (if possible)
3582   o Make exit nodes resolve IPs to IPs immediately, rather than asking
3583     the dns farm to do it.
3584   o Fix c99 aliasing warnings in rephist.c
3585   o Don't include server descriptors that are older than 24 hours in the
3586     directory.
3587   o Give socks 'reject' replies their whole 15s to attempt to flush,
3588     rather than seeing the 60s timeout and assuming the flush had failed.
3589   o Clean automake droppings from the cvs repository
3590   o Add in a 'notice' log level for things the operator should hear
3591     but that aren't warnings
3594 Changes in version 0.0.4 - 2004-03-26
3595   o When connecting to a dirserver or OR and the network is down,
3596     we would crash.
3599 Changes in version 0.0.3 - 2004-03-26
3600   o Warn and fail if server chose a nickname with illegal characters
3601   o Port to Solaris and Sparc:
3602     - include missing header fcntl.h
3603     - have autoconf find -lsocket -lnsl automatically
3604     - deal with hardware word alignment
3605     - make uname() work (solaris has a different return convention)
3606     - switch from using signal() to sigaction()
3607   o Preliminary work on reputation system:
3608     - Keep statistics on success/fail of connect attempts; they're published
3609       by kill -USR1 currently.
3610     - Add a RunTesting option to try to learn link state by creating test
3611       circuits, even when SocksPort is off.
3612     - Remove unused open circuits when there are too many.
3615 Changes in version 0.0.2 - 2004-03-19
3616     - Include strlcpy and strlcat for safer string ops
3617     - define INADDR_NONE so we compile (but still not run) on solaris
3620 Changes in version 0.0.2pre27 - 2004-03-14
3621   o Bugfixes:
3622     - Allow internal tor networks (we were rejecting internal IPs,
3623       now we allow them if they're set explicitly).
3624     - And fix a few endian issues.
3627 Changes in version 0.0.2pre26 - 2004-03-14
3628   o New features:
3629     - If a stream times out after 15s without a connected cell, don't
3630       try that circuit again: try a new one.
3631     - Retry streams at most 4 times. Then give up.
3632     - When a dirserver gets a descriptor from an unknown router, it
3633       logs its fingerprint (so the dirserver operator can choose to
3634       accept it even without mail from the server operator).
3635     - Inform unapproved servers when we reject their descriptors.
3636     - Make tor build on Windows again. It works as a client, who knows
3637       about as a server.
3638     - Clearer instructions in the torrc for how to set up a server.
3639     - Be more efficient about reading fd's when our global token bucket
3640       (used for rate limiting) becomes empty.
3641   o Bugfixes:
3642     - Stop asserting that computers always go forward in time. It's
3643       simply not true.
3644     - When we sent a cell (e.g. destroy) and then marked an OR connection
3645       expired, we might close it before finishing a flush if the other
3646       side isn't reading right then.
3647     - Don't allow dirservers to start if they haven't defined
3648       RecommendedVersions
3649     - We were caching transient dns failures. Oops.
3650     - Prevent servers from publishing an internal IP as their address.
3651     - Address a strcat vulnerability in circuit.c
3654 Changes in version 0.0.2pre25 - 2004-03-04
3655   o New features:
3656     - Put the OR's IP in its router descriptor, not its fqdn. That way
3657       we'll stop being stalled by gethostbyname for nodes with flaky dns,
3658       e.g. poblano.
3659   o Bugfixes:
3660     - If the user typed in an address that didn't resolve, the server
3661       crashed.
3664 Changes in version 0.0.2pre24 - 2004-03-03
3665   o Bugfixes:
3666     - Fix an assertion failure in dns.c, where we were trying to dequeue
3667       a pending dns resolve even if it wasn't pending
3668     - Fix a spurious socks5 warning about still trying to write after the
3669       connection is finished.
3670     - Hold certain marked_for_close connections open until they're finished
3671       flushing, rather than losing bytes by closing them too early.
3672     - Correctly report the reason for ending a stream
3673     - Remove some duplicate calls to connection_mark_for_close
3674     - Put switch_id and start_daemon earlier in the boot sequence, so it
3675       will actually try to chdir() to options.DataDirectory
3676     - Make 'make test' exit(1) if a test fails; fix some unit tests
3677     - Make tor fail when you use a config option it doesn't know about,
3678       rather than warn and continue.
3679     - Make --version work
3680     - Bugfixes on the rpm spec file and tor.sh, so it's more up to date
3683 Changes in version 0.0.2pre23 - 2004-02-29
3684   o New features:
3685     - Print a statement when the first circ is finished, so the user
3686       knows it's working.
3687     - If a relay cell is unrecognized at the end of the circuit,
3688       send back a destroy. (So attacks to mutate cells are more
3689       clearly thwarted.)
3690     - New config option 'excludenodes' to avoid certain nodes for circuits.
3691     - When it daemonizes, it chdir's to the DataDirectory rather than "/",
3692       so you can collect coredumps there.
3693  o Bugfixes:
3694     - Fix a bug in tls flushing where sometimes data got wedged and
3695       didn't flush until more data got sent. Hopefully this bug was
3696       a big factor in the random delays we were seeing.
3697     - Make 'connected' cells include the resolved IP, so the client
3698       dns cache actually gets populated.
3699     - Disallow changing from ORPort=0 to ORPort>0 on hup.
3700     - When we time-out on a stream and detach from the circuit, send an
3701       end cell down it first.
3702     - Only warn about an unknown router (in exitnodes, entrynodes,
3703       excludenodes) after we've fetched a directory.
3706 Changes in version 0.0.2pre22 - 2004-02-26
3707   o New features:
3708     - Servers publish less revealing uname information in descriptors.
3709     - More memory tracking and assertions, to crash more usefully when
3710       errors happen.
3711     - If the default torrc isn't there, just use some default defaults.
3712       Plus provide an internal dirservers file if they don't have one.
3713     - When the user tries to use Tor as an http proxy, give them an http
3714       501 failure explaining that we're a socks proxy.
3715     - Dump a new router.desc on hup, to help confused people who change
3716       their exit policies and then wonder why router.desc doesn't reflect
3717       it.
3718     - Clean up the generic tor.sh init script that we ship with.
3719   o Bugfixes:
3720     - If the exit stream is pending on the resolve, and a destroy arrives,
3721       then the stream wasn't getting removed from the pending list. I
3722       think this was the one causing recent server crashes.
3723     - Use a more robust poll on OSX 10.3, since their poll is flaky.
3724     - When it couldn't resolve any dirservers, it was useless from then on.
3725       Now it reloads the RouterFile (or default dirservers) if it has no
3726       dirservers.
3727     - Move the 'tor' binary back to /usr/local/bin/ -- it turns out
3728       many users don't even *have* a /usr/local/sbin/.
3731 Changes in version 0.0.2pre21 - 2004-02-18
3732   o New features:
3733     - There's a ChangeLog file that actually reflects the changelog.
3734     - There's a 'torify' wrapper script, with an accompanying
3735       tor-tsocks.conf, that simplifies the process of using tsocks for
3736       tor. It even has a man page.
3737     - The tor binary gets installed to sbin rather than bin now.
3738     - Retry streams where the connected cell hasn't arrived in 15 seconds
3739     - Clean up exit policy handling -- get the default out of the torrc,
3740       so we can update it without forcing each server operator to fix
3741       his/her torrc.
3742     - Allow imaps and pop3s in default exit policy
3743   o Bugfixes:
3744     - Prevent picking middleman nodes as the last node in the circuit
3747 Changes in version 0.0.2pre20 - 2004-01-30
3748   o New features:
3749     - We now have a deb package, and it's in debian unstable. Go to
3750       it, apt-getters. :)
3751     - I've split the TotalBandwidth option into BandwidthRate (how many
3752       bytes per second you want to allow, long-term) and
3753       BandwidthBurst (how many bytes you will allow at once before the cap
3754       kicks in).  This better token bucket approach lets you, say, set
3755       BandwidthRate to 10KB/s and BandwidthBurst to 10MB, allowing good
3756       performance while not exceeding your monthly bandwidth quota.
3757     - Push out a tls record's worth of data once you've got it, rather
3758       than waiting until you've read everything waiting to be read. This
3759       may improve performance by pipelining better. We'll see.
3760     - Add an AP_CONN_STATE_CONNECTING state, to allow streams to detach
3761       from failed circuits (if they haven't been connected yet) and attach
3762       to new ones.
3763     - Expire old streams that haven't managed to connect. Some day we'll
3764       have them reattach to new circuits instead.
3766   o Bugfixes:
3767     - Fix several memory leaks that were causing servers to become bloated
3768       after a while.
3769     - Fix a few very rare assert triggers. A few more remain.
3770     - Setuid to User _before_ complaining about running as root.
3773 Changes in version 0.0.2pre19 - 2004-01-07
3774   o Bugfixes:
3775     - Fix deadlock condition in dns farm. We were telling a child to die by
3776       closing the parent's file descriptor to him. But newer children were
3777       inheriting the open file descriptor from the parent, and since they
3778       weren't closing it, the socket never closed, so the child never read
3779       eof, so he never knew to exit. Similarly, dns workers were holding
3780       open other sockets, leading to all sorts of chaos.
3781     - New cleaner daemon() code for forking and backgrounding.
3782     - If you log to a file, it now prints an entry at the top of the
3783       logfile so you know it's working.
3784     - The onionskin challenge length was 30 bytes longer than necessary.
3785     - Started to patch up the spec so it's not quite so out of date.
3788 Changes in version 0.0.2pre18 - 2004-01-02
3789   o Bugfixes:
3790     - Fix endian issues with the 'integrity' field in the relay header.
3791     - Fix a potential bug where connections in state
3792       AP_CONN_STATE_CIRCUIT_WAIT might unexpectedly ask to write.
3795 Changes in version 0.0.2pre17 - 2003-12-30
3796   o Bugfixes:
3797     - Made --debuglogfile (or any second log file, actually) work.
3798     - Resolved an edge case in get_unique_circ_id_by_conn where a smart
3799       adversary could force us into an infinite loop.
3801   o Features:
3802     - Each onionskin handshake now includes a hash of the computed key,
3803       to prove the server's identity and help perfect forward secrecy.
3804     - Changed cell size from 256 to 512 bytes (working toward compatibility
3805       with MorphMix).
3806     - Changed cell length to 2 bytes, and moved it to the relay header.
3807     - Implemented end-to-end integrity checking for the payloads of
3808       relay cells.
3809     - Separated streamid from 'recognized' (otherwise circuits will get
3810       messed up when we try to have streams exit from the middle). We
3811       use the integrity-checking to confirm that a cell is addressed to
3812       this hop.
3813     - Randomize the initial circid and streamid values, so an adversary who
3814       breaks into a node can't learn how many circuits or streams have
3815       been made so far.
3818 Changes in version 0.0.2pre16 - 2003-12-14
3819   o Bugfixes:
3820     - Fixed a bug that made HUP trigger an assert
3821     - Fixed a bug where a circuit that immediately failed wasn't being
3822       counted as a failed circuit in counting retries.
3824   o Features:
3825     - Now we close the circuit when we get a truncated cell: otherwise we're
3826       open to an anonymity attack where a bad node in the path truncates
3827       the circuit and then we open streams at him.
3828     - Add port ranges to exit policies
3829     - Add a conservative default exit policy
3830     - Warn if you're running tor as root
3831     - on HUP, retry OR connections and close/rebind listeners
3832     - options.EntryNodes: try these nodes first when picking the first node
3833     - options.ExitNodes: if your best choices happen to include any of
3834       your preferred exit nodes, you choose among just those preferred
3835       exit nodes.
3836     - options.ExcludedNodes: nodes that are never picked in path building
3839 Changes in version 0.0.2pre15 - 2003-12-03
3840   o Robustness and bugfixes:
3841     - Sometimes clients would cache incorrect DNS resolves, which would
3842       really screw things up.
3843     - An OP that goes offline would slowly leak all its sockets and stop
3844       working.
3845     - A wide variety of bugfixes in exit node selection, exit policy
3846       handling, and processing pending streams when a new circuit is
3847       established.
3848     - Pick nodes for a path only from those the directory says are up
3849     - Choose randomly from all running dirservers, not always the first one
3850     - Increase allowed http header size for directory fetch.
3851     - Stop writing to stderr (if we're daemonized it will be closed).
3852     - Enable -g always, so cores will be more useful to me.
3853     - Switch "-lcrypto -lssl" to "-lssl -lcrypto" for broken distributions.
3855   o Documentation:
3856     - Wrote a man page. It lists commonly used options.
3858   o Configuration:
3859     - Change default loglevel to warn.
3860     - Make PidFile default to null rather than littering in your CWD.
3861     - OnionRouter config option is now obsolete. Instead it just checks
3862       ORPort>0.
3863     - Moved to a single unified torrc file for both clients and servers.
3866 Changes in version 0.0.2pre14 - 2003-11-29
3867   o Robustness and bugfixes:
3868     - Force the admin to make the DataDirectory himself
3869       - to get ownership/permissions right
3870       - so clients no longer make a DataDirectory and then never use it
3871     - fix bug where a client who was offline for 45 minutes would never
3872       pull down a directory again
3873     - fix (or at least hide really well) the dns assert bug that was
3874       causing server crashes
3875     - warnings and improved robustness wrt clockskew for certs
3876     - use the native daemon(3) to daemonize, when available
3877     - exit if bind() fails
3878     - exit if neither socksport nor orport is defined
3879     - include our own tor_timegm (Win32 doesn't have its own)
3880     - bugfix for win32 with lots of connections
3881     - fix minor bias in PRNG
3882     - make dirserver more robust to corrupt cached directory
3884   o Documentation:
3885     - Wrote the design document (woo)
3887   o Circuit building and exit policies:
3888     - Circuits no longer try to use nodes that the directory has told them
3889       are down.
3890     - Exit policies now support bitmasks (18.0.0.0/255.0.0.0) and
3891       bitcounts (18.0.0.0/8).
3892     - Make AP connections standby for a circuit if no suitable circuit
3893       exists, rather than failing
3894     - Circuits choose exit node based on addr/port, exit policies, and
3895       which AP connections are standing by
3896     - Bump min pathlen from 2 to 3
3897     - Relay end cells have a payload to describe why the stream ended.
3898     - If the stream failed because of exit policy, try again with a new
3899       circuit.
3900     - Clients have a dns cache to remember resolved addresses.
3901     - Notice more quickly when we have no working circuits
3903   o Configuration:
3904     - APPort is now called SocksPort
3905     - SocksBindAddress, ORBindAddress, DirBindAddress let you configure
3906       where to bind
3907     - RecommendedVersions is now a config variable rather than
3908       hardcoded (for dirservers)
3909     - Reloads config on HUP
3910     - Usage info on -h or --help
3911     - If you set User and Group config vars, it'll setu/gid to them.
3913 Changes in version 0.0.2pre13 - 2003-10-19
3914   o General stability:
3915     - SSL_write no longer fails when it returns WANTWRITE and the number
3916       of bytes in the buf has changed by the next SSL_write call.
3917     - Fix segfault fetching directory when network is down
3918     - Fix a variety of minor memory leaks
3919     - Dirservers reload the fingerprints file on HUP, so I don't have
3920       to take down the network when I approve a new router
3921     - Default server config file has explicit Address line to specify fqdn
3923   o Buffers:
3924     - Buffers grow and shrink as needed (Cut process size from 20M to 2M)
3925     - Make listener connections not ever alloc bufs
3927   o Autoconf improvements:
3928     - don't clobber an external CFLAGS in ./configure
3929     - Make install now works
3930     - create var/lib/tor on make install
3931     - autocreate a tor.sh initscript to help distribs
3932     - autocreate the torrc and sample-server-torrc with correct paths
3934   o Log files and Daemonizing now work:
3935     - If --DebugLogFile is specified, log to it at -l debug
3936     - If --LogFile is specified, use it instead of commandline
3937     - If --RunAsDaemon is set, tor forks and backgrounds on startup