bump to 0.2.3.22-rc
[tor.git] / ChangeLog
1 Changes in version 0.2.3.22-rc - 2012-09-11
2   Tor 0.2.3.22-rc fixes another opportunity for a remotely triggerable
3   assertion.
4
5   o Security fixes:
6     - Fix an assertion failure in tor_timegm() that could be triggered
7       by a badly formatted directory object. Bug found by fuzzing with
8       Radamsa. Fixes bug 6811; bugfix on 0.2.0.20-rc.
9
10   o Minor bugfixes:
11     - Avoid segfault when starting up having run with an extremely old
12       version of Tor and parsing its state file. Fixes bug 6801; bugfix
13       on 0.2.2.23-alpha.
14
15
16 Changes in version 0.2.2.39 - 2012-09-11
17   Tor 0.2.2.39 fixes two more opportunities for remotely triggerable
18   assertions.
19
20   o Security fixes:
21     - Fix an assertion failure in tor_timegm() that could be triggered
22       by a badly formatted directory object. Bug found by fuzzing with
23       Radamsa. Fixes bug 6811; bugfix on 0.2.0.20-rc.
24     - Do not crash when comparing an address with port value 0 to an
25       address policy. This bug could have been used to cause a remote
26       assertion failure by or against directory authorities, or to
27       allow some applications to crash clients. Fixes bug 6690; bugfix
28       on 0.2.1.10-alpha.
29
30
31 Changes in version 0.2.3.21-rc - 2012-09-05
32   Tor 0.2.3.21-rc is the fourth release candidate for the Tor 0.2.3.x
33   series. It fixes a trio of potential security bugs, fixes a bug where
34   we were leaving some of the fast relays out of the microdescriptor
35   consensus, resumes interpreting "ORPort 0" and "DirPort 0" correctly,
36   and cleans up other smaller issues.
37
38   o Major bugfixes (security):
39     - Tear down the circuit if we get an unexpected SENDME cell. Clients
40       could use this trick to make their circuits receive cells faster
41       than our flow control would have allowed, or to gum up the network,
42       or possibly to do targeted memory denial-of-service attacks on
43       entry nodes. Fixes bug 6252. Bugfix on the 54th commit on Tor --
44       from July 2002, before the release of Tor 0.0.0. We had committed
45       this patch previously, but we had to revert it because of bug 6271.
46       Now that 6271 is fixed, this patch appears to work.
47     - Reject any attempt to extend to an internal address. Without
48       this fix, a router could be used to probe addresses on an internal
49       network to see whether they were accepting connections. Fixes bug
50       6710; bugfix on 0.0.8pre1.
51     - Do not crash when comparing an address with port value 0 to an
52       address policy. This bug could have been used to cause a remote
53       assertion failure by or against directory authorities, or to
54       allow some applications to crash clients. Fixes bug 6690; bugfix
55       on 0.2.1.10-alpha.
56
57   o Major bugfixes:
58     - Remove the upper bound on microdescriptor length. We were hitting
59       the limit for routers with complex exit policies or family
60       declarations, causing clients to not use them. Fixes the first
61       piece of bug 6404; fix on 0.2.2.6-alpha.
62     - Detect "ORPort 0" as meaning, uniformly, that we're not running
63       as a relay. Previously, some of our code would treat the presence
64       of any ORPort line as meaning that we should act like a relay,
65       even though our new listener code would correctly not open any
66       ORPorts for ORPort 0. Similar bugs in other Port options are also
67       fixed. Fixes the first half of bug 6507; bugfix on 0.2.3.3-alpha.
68
69   o Minor bugfixes:
70     - Avoid a pair of double-free and use-after-mark bugs that can
71       occur with certain timings in canceled and re-received DNS
72       requests. Fixes bug 6472; bugfix on 0.0.7rc1.
73     - Fix build and 64-bit compile warnings from --enable-openbsd-malloc.
74       Fixes bug 6379. Bugfix on 0.2.0.20-rc.
75     - Allow one-hop directory fetching circuits the full "circuit build
76       timeout" period, rather than just half of it, before failing them
77       and marking the relay down. This fix should help reduce cases where
78       clients declare relays (or worse, bridges) unreachable because
79       the TLS handshake takes a few seconds to complete. Fixes bug 6743;
80       bugfix on 0.2.2.2-alpha, where we changed the timeout from a static
81       30 seconds.
82     - Authorities no longer include any router in their microdescriptor
83       consensuses for which they couldn't generate or agree on a
84       microdescriptor. Fixes the second piece of bug 6404; fix on
85       0.2.2.6-alpha.
86     - Detect and reject attempts to specify both "FooPort" and
87       "FooPort 0" in the same configuration domain. (It's still okay
88       to have a FooPort in your configuration file, and use "FooPort 0"
89       on the command line to disable it.) Fixes the second half of bug
90       6507; bugfix on 0.2.3.3-alpha.
91     - Make wildcarded addresses (that is, ones beginning with "*.") work
92       when provided via the controller's MapAddress command. Previously,
93       they were accepted, but we never actually noticed that they were
94       wildcards. Fixes bug 6244; bugfix on 0.2.3.9-alpha.
95     - Avoid crashing on a malformed state file where EntryGuardPathBias
96       precedes EntryGuard. Fixes bug 6774; bugfix on 0.2.3.17-beta.
97     - Add a (probably redundant) memory clear between iterations of
98       the router status voting loop, to prevent future coding errors
99       where data might leak between iterations of the loop. Resolves
100       ticket 6514.
101
102   o Minor bugfixes (log messages):
103     - Downgrade "set buildtimeout to low value" messages to "info"
104       severity; they were never an actual problem, there was never
105       anything reasonable to do about them, and they tended to spam logs
106       from time to time. Fixes bug 6251; bugfix on 0.2.2.2-alpha.
107     - Downgrade path-bias warning messages to "info". We'll try to get
108       them working better in 0.2.4. Add internal circuit construction
109       state to protect against the noisy warn message "Unexpectedly high
110       circuit_successes". Also add some additional rate-limited notice
111       messages to help determine the root cause of the warn. Fixes bug
112       6475. Bugfix against 0.2.3.17-beta.
113     - Move log message when unable to find a microdesc in a routerstatus
114       entry to parse time. Previously we'd spam this warning every time
115       we tried to figure out which microdescriptors to download. Fixes
116       the third piece of bug 6404; fix on 0.2.3.18-rc.
117
118   o Minor features:
119     - Consider new, removed or changed IPv6 OR ports a non-cosmetic
120       change when the authority is deciding whether to accept a newly
121       uploaded descriptor. Implements ticket 6423.
122     - Add missing documentation for consensus and microdesc files.
123       Resolves ticket 6732.
124
125
126 Changes in version 0.2.2.38 - 2012-08-12
127   Tor 0.2.2.38 fixes a remotely triggerable crash bug, and fixes a timing
128   attack that could in theory leak path information.
129
130   o Security fixes:
131     - Avoid an uninitialized memory read when reading a vote or consensus
132       document that has an unrecognized flavor name. This read could
133       lead to a remote crash bug. Fixes bug 6530; bugfix on 0.2.2.6-alpha.
134     - Try to leak less information about what relays a client is
135       choosing to a side-channel attacker. Previously, a Tor client would
136       stop iterating through the list of available relays as soon as it
137       had chosen one, thus finishing a little earlier when it picked
138       a router earlier in the list. If an attacker can recover this
139       timing information (nontrivial but not proven to be impossible),
140       they could learn some coarse-grained information about which relays
141       a client was picking (middle nodes in particular are likelier to
142       be affected than exits). The timing attack might be mitigated by
143       other factors (see bug 6537 for some discussion), but it's best
144       not to take chances. Fixes bug 6537; bugfix on 0.0.8rc1.
145
146
147 Changes in version 0.2.3.20-rc - 2012-08-05
148   Tor 0.2.3.20-rc is the third release candidate for the Tor 0.2.3.x
149   series. It fixes a pair of code security bugs and a potential anonymity
150   issue, updates our RPM spec files, and cleans up other smaller issues.
151
152   o Security fixes:
153     - Avoid read-from-freed-memory and double-free bugs that could occur
154       when a DNS request fails while launching it. Fixes bug 6480;
155       bugfix on 0.2.0.1-alpha.
156     - Avoid an uninitialized memory read when reading a vote or consensus
157       document that has an unrecognized flavor name. This read could
158       lead to a remote crash bug. Fixes bug 6530; bugfix on 0.2.2.6-alpha.
159     - Try to leak less information about what relays a client is
160       choosing to a side-channel attacker. Previously, a Tor client would
161       stop iterating through the list of available relays as soon as it
162       had chosen one, thus finishing a little earlier when it picked
163       a router earlier in the list. If an attacker can recover this
164       timing information (nontrivial but not proven to be impossible),
165       they could learn some coarse-grained information about which relays
166       a client was picking (middle nodes in particular are likelier to
167       be affected than exits). The timing attack might be mitigated by
168       other factors (see bug 6537 for some discussion), but it's best
169       not to take chances. Fixes bug 6537; bugfix on 0.0.8rc1.
170
171   o Minor features:
172     - Try to make the warning when giving an obsolete SOCKSListenAddress
173       a little more useful.
174     - Terminate active server managed proxies if Tor stops being a
175       relay. Addresses parts of bug 6274; bugfix on 0.2.3.6-alpha.
176     - Provide a better error message about possible OSX Asciidoc failure
177       reasons. Fixes bug 6436.
178     - Warn when Tor is configured to use accounting in a way that can
179       link a hidden service to some other hidden service or public
180       address. Resolves ticket 6490.
181
182   o Minor bugfixes:
183     - Check return value of fputs() when writing authority certificate
184       file. Fixes Coverity issue 709056; bugfix on 0.2.0.1-alpha.
185     - Ignore ServerTransportPlugin lines when Tor is not configured as
186       a relay. Fixes bug 6274; bugfix on 0.2.3.6-alpha.
187     - When disabling guards for having too high a proportion of failed
188       circuits, make sure to look at each guard. Fixes bug 6397; bugfix
189       on 0.2.3.17-beta.
190
191   o Packaging (RPM):
192     - Update our default RPM spec files to work with mock and rpmbuild
193       on RHEL/Fedora. They have an updated set of dependencies and
194       conflicts, a fix for an ancient typo when creating the "_tor"
195       user, and better instructions. Thanks to Ondrej Mikle for the
196       patch series. Fixes bug 6043.
197
198   o Testing:
199     - Make it possible to set the TestingTorNetwork configuration
200       option using AlternateDirAuthority and AlternateBridgeAuthority
201       as an alternative to setting DirServer. Addresses ticket 6377.
202
203   o Documentation:
204     - Clarify the documentation for the Alternate*Authority options.
205       Fixes bug 6387.
206     - Fix some typos in the manpages. Patch from A. Costa. Fixes bug 6500.
207
208   o Code simplification and refactoring:
209     - Do not use SMARTLIST_FOREACH for any loop whose body exceeds
210       10 lines. Also, don't nest them. Doing so in the past has
211       led to hard-to-debug code. The new style is to use the
212       SMARTLIST_FOREACH_{BEGIN,END} pair. Addresses issue 6400.
213
214
215 Changes in version 0.2.3.19-rc - 2012-07-06
216   Tor 0.2.3.19-rc is the second release candidate for the Tor 0.2.3.x
217   series. It fixes the compile on Windows, reverts to a GeoIP database
218   that isn't as broken, and fixes a flow control bug that has been around
219   since the beginning of Tor.
220
221   o Major bugfixes:
222     - Fix a bug handling SENDME cells on nonexistent streams that could
223       result in bizarre window values. Report and patch contributed
224       pseudonymously. Fixes part of bug 6271. This bug was introduced
225       before the first Tor release, in svn commit r152.
226     - Revert to the May 1 2012 Maxmind GeoLite Country database. In the
227       June 2012 database, Maxmind marked many Tor relays as country "A1",
228       which will cause risky behavior for clients that set EntryNodes
229       or ExitNodes. Addresses bug 6334; bugfix on 0.2.3.17-beta.
230     - Instead of ENOBUFS on Windows, say WSAENOBUFS. Fixes compilation
231       on Windows. Fixes bug 6296; bugfix on 0.2.3.18-rc.
232
233   o Minor bugfixes:
234     - Fix wrong TCP port range in parse_port_range(). Fixes bug 6218;
235       bugfix on 0.2.1.10-alpha.
236
237
238 Changes in version 0.2.3.18-rc - 2012-06-28
239   Tor 0.2.3.18-rc is the first release candidate for the Tor 0.2.3.x
240   series. It fixes a few smaller bugs, but generally appears stable.
241   Please test it and let us know whether it is!
242
243   o Major bugfixes:
244     - Allow wildcarded mapaddress targets to be specified on the
245       controlport. Partially fixes bug 6244; bugfix on 0.2.3.9-alpha.
246     - Make our linker option detection code more robust against linkers
247       such as on FreeBSD 8, where a bad combination of options completes
248       successfully but makes an unrunnable binary. Fixes bug 6173;
249       bugfix on 0.2.3.17-beta.
250
251   o Minor bugfixes (on 0.2.2.x and earlier):
252     - Avoid a false positive in the util/threads unit test by increasing
253       the maximum timeout time. Fixes bug 6227; bugfix on 0.2.0.4-alpha.
254     - Replace "Sending publish request" log messages with "Launching
255       upload", so that they no longer confusingly imply that we're
256       sending something to a directory we might not even be connected
257       to yet. Fixes bug 3311; bugfix on 0.2.0.10-alpha.
258     - Make sure to set *socket_error in all error cases in
259       connection_connect(), so it can't produce a warning about
260       errno being zero from errno_to_orconn_end_reason(). Bugfix on
261       0.2.1.1-alpha; resolves ticket 6028.
262     - Downgrade "Got a certificate, but we already have it" log messages
263       from warning to info, except when we're a dirauth. Fixes bug 5238;
264       bugfix on 0.2.1.7-alpha.
265     - When checking for requested signatures on the latest consensus
266       before serving it to a client, make sure to check the right
267       consensus flavor. Bugfix on 0.2.2.6-alpha.
268     - Downgrade "eventdns rejected address" message to LOG_PROTOCOL_WARN.
269       Fixes bug 5932; bugfix on 0.2.2.7-alpha.
270
271   o Minor bugfixes (on 0.2.3.x):
272     - Make format_helper_exit_status() avoid unnecessary space padding
273       and stop confusing log_from_pipe(). Fixes ticket 5557; bugfix
274       on 0.2.3.1-alpha.
275     - Downgrade a message about cleaning the microdescriptor cache to
276       "info" from "notice". Fixes bug 6238; bugfix on 0.2.3.1-alpha.
277     - Log a BUG message at severity INFO if we have a networkstatus with
278       a missing entry for some microdescriptor. Continues on a patch
279       to 0.2.3.2-alpha.
280     - Improve the log message when a managed proxy fails to launch. Fixes
281       bug 5099; bugfix on 0.2.3.6-alpha.
282     - Don't do DNS lookups when parsing corrupted managed proxy protocol
283       messages. Fixes bug 6226; bugfix on 0.2.3.6-alpha.
284     - When formatting wildcarded address mappings for the controller,
285       be sure to include "*." as appropriate. Partially fixes bug 6244;
286       bugfix on 0.2.3.9-alpha.
287     - Avoid a warning caused by using strcspn() from glibc with clang 3.0.
288       Bugfix on 0.2.3.13-alpha.
289     - Stop logging messages about running with circuit timeout learning
290       enabled at severity LD_BUG. Fixes bug 6169; bugfix on 0.2.3.17-beta.
291     - Disable a spurious warning about reading on a marked and flushing
292       connection. We shouldn't be doing that, but apparently we
293       sometimes do. Fixes bug 6203; bugfix on 0.2.3.17-beta.
294     - Fix a bug that stopped AllowDotExit from working on addresses
295       that had an entry in the DNS cache. Fixes bug 6211; bugfix on
296       0.2.3.17-beta.
297
298   o Code simplification, refactoring, unit tests:
299     - Move tor_gettimeofday_cached() into compat_libevent.c, and use
300       Libevent's notion of cached time when possible.
301     - Remove duplicate code for invoking getrlimit() from control.c.
302     - Add a unit test for the environment_variable_names_equal function.
303
304   o Documentation:
305     - Document the --defaults-torrc option, and the new (in 0.2.3)
306       semantics for overriding, extending, and clearing lists of
307       options. Closes bug 4748.
308
309
310 Changes in version 0.2.3.17-beta - 2012-06-15
311   Tor 0.2.3.17-beta enables compiler and linker hardening by default,
312   gets our TLS handshake back on track for being able to blend in with
313   Firefox, fixes a big bug in 0.2.3.16-alpha that broke Tor's interaction
314   with Vidalia, and otherwise continues to get us closer to a release
315   candidate.
316
317   o Major features:
318     - Enable gcc and ld hardening by default. Resolves ticket 5210.
319     - Update TLS cipher list to match Firefox 8 and later. Resolves
320       ticket 4744.
321     - Implement the client side of proposal 198: remove support for
322       clients falsely claiming to support standard ciphersuites that
323       they can actually provide. As of modern OpenSSL versions, it's not
324       necessary to fake any standard ciphersuite, and doing so prevents
325       us from using better ciphersuites in the future, since servers
326       can't know whether an advertised ciphersuite is really supported or
327       not. Some hosts -- notably, ones with very old versions of OpenSSL
328       or where OpenSSL has been built with ECC disabled -- will stand
329       out because of this change; TBB users should not be affected.
330
331   o Major bugfixes:
332     - Change the default value for DynamicDHGroups (introduced in
333       0.2.3.9-alpha) to 0. This feature can make Tor relays less
334       identifiable by their use of the mod_ssl DH group, but at
335       the cost of some usability (#4721) and bridge tracing (#6087)
336       regressions. Resolves ticket 5598.
337     - Send a CRLF at the end of each STATUS_* control protocol event. This
338       bug tickled a bug in Vidalia which would make it freeze. Fixes
339       bug 6094; bugfix on 0.2.3.16-alpha.
340
341   o Minor bugfixes:
342     - Disable writing on marked-for-close connections when they are
343       blocked on bandwidth, to prevent busy-looping in Libevent. Fixes
344       bug 5263; bugfix on 0.0.2pre13, where we first added a special
345       case for flushing marked connections.
346     - Detect SSL handshake even when the initial attempt to write the
347       server hello fails. Fixes bug 4592; bugfix on 0.2.0.13-alpha.
348     - Change the AllowDotExit rules so they should actually work.
349       We now enforce AllowDotExit only immediately after receiving an
350       address via SOCKS or DNSPort: other sources are free to provide
351       .exit addresses after the resolution occurs. Fixes bug 3940;
352       bugfix on 0.2.2.1-alpha.
353     - Fix a (harmless) integer overflow in cell statistics reported by
354       some fast relays. Fixes bug 5849; bugfix on 0.2.2.1-alpha.
355     - Make sure circuitbuild.c checks LearnCircuitBuildTimeout in all the
356       right places and never depends on the consensus parameters or
357       computes adaptive timeouts when it is disabled. Fixes bug 5049;
358       bugfix on 0.2.2.14-alpha.
359     - When building Tor on Windows with -DUNICODE (not default), ensure
360       that error messages, filenames, and DNS server names are always
361       NUL-terminated when we convert them to a single-byte encoding.
362       Fixes bug 5909; bugfix on 0.2.2.16-alpha.
363     - Make Tor build correctly again with -DUNICODE -D_UNICODE defined.
364       Fixes bug 6097; bugfix on 0.2.2.16-alpha.
365     - Fix an edge case where TestingTorNetwork is set but the authorities
366       and relays all have an uptime of zero, where the private Tor network
367       could briefly lack support for hidden services. Fixes bug 3886;
368       bugfix on 0.2.2.18-alpha.
369     - Correct the manpage's descriptions for the default values of
370       DirReqStatistics and ExtraInfoStatistics. Fixes bug 2865; bugfix
371       on 0.2.3.1-alpha.
372     - Fix the documentation for the --hush and --quiet command line
373       options, which changed their behavior back in 0.2.3.3-alpha.
374     - Fix compilation warning with clang 3.1. Fixes bug 6141; bugfix on
375       0.2.3.11-alpha.
376
377   o Minor features:
378     - Rate-limit the "Weighted bandwidth is 0.000000" message, and add
379       more information to it, so that we can track it down in case it
380       returns again. Mitigates bug 5235.
381     - Check CircuitBuildTimeout and LearnCircuitBuildTimeout in
382       options_validate(); warn if LearnCircuitBuildTimeout is disabled and
383       CircuitBuildTimeout is set unreasonably low. Resolves ticket 5452.
384     - Warn the user when HTTPProxy, but no other proxy type, is
385       configured. This can cause surprising behavior: it doesn't send
386       all of Tor's traffic over the HTTPProxy -- it sends unencrypted
387       directory traffic only. Resolves ticket 4663.
388     - Issue a notice if a guard completes less than 40% of your circuits.
389       Threshold is configurable by torrc option PathBiasNoticeRate and
390       consensus parameter pb_noticepct. There is additional, off-by-
391       default code to disable guards which fail too many circuits.
392       Addresses ticket 5458.
393     - Update to the June 6 2012 Maxmind GeoLite Country database.
394
395   o Code simplifications and refactoring:
396     - Remove validate_pluggable_transports_config(): its warning
397       message is now handled by connection_or_connect().
398
399
400 Changes in version 0.2.2.37 - 2012-06-06
401   Tor 0.2.2.37 introduces a workaround for a critical renegotiation
402   bug in OpenSSL 1.0.1 (where 20% of the Tor network can't talk to itself
403   currently).
404
405   o Major bugfixes:
406     - Work around a bug in OpenSSL that broke renegotiation with TLS
407       1.1 and TLS 1.2. Without this workaround, all attempts to speak
408       the v2 Tor connection protocol when both sides were using OpenSSL
409       1.0.1 would fail. Resolves ticket 6033.
410     - When waiting for a client to renegotiate, don't allow it to add
411       any bytes to the input buffer. This fixes a potential DoS issue.
412       Fixes bugs 5934 and 6007; bugfix on 0.2.0.20-rc.
413     - Fix an edge case where if we fetch or publish a hidden service
414       descriptor, we might build a 4-hop circuit and then use that circuit
415       for exiting afterwards -- even if the new last hop doesn't obey our
416       ExitNodes config option. Fixes bug 5283; bugfix on 0.2.0.10-alpha.
417
418   o Minor bugfixes:
419     - Fix a build warning with Clang 3.1 related to our use of vasprintf.
420       Fixes bug 5969. Bugfix on 0.2.2.11-alpha.
421
422   o Minor features:
423     - Tell GCC and Clang to check for any errors in format strings passed
424       to the tor_v*(print|scan)f functions.
425
426
427 Changes in version 0.2.3.16-alpha - 2012-06-05
428   Tor 0.2.3.16-alpha introduces a workaround for a critical renegotiation
429   bug in OpenSSL 1.0.1 (where 20% of the Tor network can't talk to itself
430   currently). It also fixes a variety of smaller bugs and other cleanups
431   that get us closer to a release candidate.
432
433   o Major bugfixes (general):
434     - Work around a bug in OpenSSL that broke renegotiation with TLS
435       1.1 and TLS 1.2. Without this workaround, all attempts to speak
436       the v2 Tor connection protocol when both sides were using OpenSSL
437       1.0.1 would fail. Resolves ticket 6033.
438     - When waiting for a client to renegotiate, don't allow it to add
439       any bytes to the input buffer. This fixes a potential DoS issue.
440       Fixes bugs 5934 and 6007; bugfix on 0.2.0.20-rc.
441     - Pass correct OR address to managed proxies (like obfsproxy),
442       even when ORListenAddress is used. Fixes bug 4865; bugfix on
443       0.2.3.9-alpha.
444     - The advertised platform of a router now includes only its operating
445       system's name (e.g., "Linux", "Darwin", "Windows 7"), and not its
446       service pack level (for Windows) or its CPU architecture (for Unix).
447       We also no longer include the "git-XYZ" tag in the version. Resolves
448       part of bug 2988.
449
450   o Major bugfixes (clients):
451     - If we are unable to find any exit that supports our predicted ports,
452       stop calling them predicted, so that we don't loop and build
453       hopeless circuits indefinitely. Fixes bug 3296; bugfix on 0.0.9pre6,
454       which introduced predicted ports.
455     - Fix an edge case where if we fetch or publish a hidden service
456       descriptor, we might build a 4-hop circuit and then use that circuit
457       for exiting afterwards -- even if the new last hop doesn't obey our
458       ExitNodes config option. Fixes bug 5283; bugfix on 0.2.0.10-alpha.
459     - Check at each new consensus whether our entry guards were picked
460       long enough ago that we should rotate them. Previously, we only
461       did this check at startup, which could lead to us holding a guard
462       indefinitely. Fixes bug 5380; bugfix on 0.2.1.14-rc.
463     - When fetching a bridge descriptor from a bridge authority,
464       always do so anonymously, whether we have been able to open
465       circuits or not. Partial fix for bug 1938; bugfix on 0.2.0.7-alpha.
466       This behavior makes it *safer* to use UpdateBridgesFromAuthority,
467       but we'll need to wait for bug 6010 before it's actually usable.
468
469   o Major bugfixes (directory authorities):
470     - When computing weight parameters, behave more robustly in the
471       presence of a bad bwweightscale value. Previously, the authorities
472       would crash if they agreed on a sufficiently broken weight_scale
473       value: now, they use a reasonable default and carry on. Partial
474       fix for 5786; bugfix on 0.2.2.17-alpha.
475     - Check more thoroughly to prevent a rogue authority from
476       double-voting on any consensus directory parameter. Previously,
477       authorities would crash in this case if the total number of
478       votes for any parameter exceeded the number of active voters,
479       but would let it pass otherwise. Partial fix for bug 5786; bugfix
480       on 0.2.2.2-alpha.
481
482   o Minor features:
483     - Rate-limit log messages when asked to connect anonymously to
484       a private address. When these hit, they tended to hit fast and
485       often. Also, don't bother trying to connect to addresses that we
486       are sure will resolve to 127.0.0.1: getting 127.0.0.1 in a directory
487       reply makes us think we have been lied to, even when the address the
488       client tried to connect to was "localhost." Resolves ticket 2822.
489     - Allow packagers to insert an extra string in server descriptor
490       platform lines by setting the preprocessor variable TOR_BUILD_TAG.
491       Resolves the rest of ticket 2988.
492     - Raise the threshold of server descriptors needed (75%) and exit
493       server descriptors needed (50%) before we will declare ourselves
494       bootstrapped. This will make clients start building circuits a
495       little later, but makes the initially constructed circuits less
496       skewed and less in conflict with further directory fetches. Fixes
497       ticket 3196.
498     - Close any connection that sends unrecognized junk before the
499       handshake. Solves an issue noted in bug 4369.
500     - Improve log messages about managed transports. Resolves ticket 5070.
501     - Tag a bridge's descriptor as "never to be sent unencrypted".
502       This shouldn't matter, since bridges don't open non-anonymous
503       connections to the bridge authority and don't allow unencrypted
504       directory connections from clients, but we might as well make
505       sure. Closes bug 5139.
506     - Expose our view of whether we have gone dormant to the controller,
507       via a new "GETINFO dormant" value. Torbutton and other controllers
508       can use this to avoid doing periodic requests through Tor while
509       it's dormant (bug 4718). Fixes bug 5954.
510     - Tell GCC and Clang to check for any errors in format strings passed
511       to the tor_v*(print|scan)f functions.
512     - Update to the May 1 2012 Maxmind GeoLite Country database.
513
514   o Minor bugfixes (already included in 0.2.2.36):
515     - Reject out-of-range times like 23:59:61 in parse_rfc1123_time().
516       Fixes bug 5346; bugfix on 0.0.8pre3.
517     - Correct parsing of certain date types in parse_http_time().
518       Without this patch, If-Modified-Since would behave
519       incorrectly. Fixes bug 5346; bugfix on 0.2.0.2-alpha. Patch from
520       Esteban Manchado Velázques.
521     - Make our number-parsing functions always treat too-large values
522       as an error, even when those values exceed the width of the
523       underlying type. Previously, if the caller provided these
524       functions with minima or maxima set to the extreme values of the
525       underlying integer type, these functions would return those
526       values on overflow rather than treating overflow as an error.
527       Fixes part of bug 5786; bugfix on 0.0.9.
528     - If we hit the error case where routerlist_insert() replaces an
529       existing (old) server descriptor, make sure to remove that
530       server descriptor from the old_routers list. Fix related to bug
531       1776. Bugfix on 0.2.2.18-alpha.
532     - Clarify the behavior of MaxCircuitDirtiness with hidden service
533       circuits. Fixes issue 5259.
534
535   o Minor bugfixes (coding cleanup, on 0.2.2.x and earlier):
536     - Prevent a null-pointer dereference when receiving a data cell
537       for a nonexistent stream when the circuit in question has an
538       empty deliver window. We don't believe this is triggerable,
539       since we don't currently allow deliver windows to become empty,
540       but the logic is tricky enough that it's better to make the code
541       robust. Fixes bug 5541; bugfix on 0.0.2pre14.
542     - Fix a memory leak when trying to launch a DNS request when the
543       network is disabled or the nameservers are unconfigurable. Fixes
544       bug 5916; bugfix on Tor 0.1.2.1-alpha (for the unconfigurable
545       nameserver case) and on 0.2.3.9-alpha (for the DisableNetwork case).
546     - Don't hold a Windows file handle open for every file mapping;
547       the file mapping handle is sufficient. Fixes bug 5951; bugfix on
548       0.1.2.1-alpha.
549     - Avoid O(n^2) performance characteristics when parsing a large
550       extrainfo cache. Fixes bug 5828; bugfix on 0.2.0.1-alpha.
551     - Format more doubles with %f, not %lf. Patch from grarpamp to make
552       Tor build correctly on older BSDs again. Fixes bug 3894; bugfix on
553       Tor 0.2.0.8-alpha.
554     - Make our replacement implementation of strtok_r() compatible with
555       the standard behavior of strtok_r(). Patch by nils. Fixes bug 5091;
556       bugfix on 0.2.2.1-alpha.
557     - Fix a NULL-pointer dereference on a badly formed
558       SETCIRCUITPURPOSE command. Found by mikeyc. Fixes bug 5796;
559       bugfix on 0.2.2.9-alpha.
560     - Fix a build warning with Clang 3.1 related to our use of vasprintf.
561       Fixes bug 5969. Bugfix on 0.2.2.11-alpha.
562     - Defensively refactor rend_mid_rendezvous() so that protocol
563       violations and length checks happen in the beginning. Fixes
564       bug 5645.
565     - Set _WIN32_WINNT to 0x0501 consistently throughout the code, so
566       that IPv6 stuff will compile on MSVC, and compilation issues
567       will be easier to track down. Fixes bug 5861.
568
569   o Minor bugfixes (correctness, on 0.2.2.x and earlier):
570     - Exit nodes now correctly report EADDRINUSE and EADDRNOTAVAIL as
571       resource exhaustion, so that clients can adjust their load to
572       try other exits. Fixes bug 4710; bugfix on 0.1.0.1-rc, which
573       started using END_STREAM_REASON_RESOURCELIMIT.
574     - Don't check for whether the address we're using for outbound
575       connections has changed until after the outbound connection has
576       completed. On Windows, getsockname() doesn't succeed until the
577       connection is finished. Fixes bug 5374; bugfix on 0.1.1.14-alpha.
578     - If the configuration tries to set MyFamily on a bridge, refuse to
579       do so, and warn about the security implications. Fixes bug 4657;
580       bugfix on 0.2.0.3-alpha.
581     - If the client fails to set a reasonable set of ciphersuites
582       during its v2 handshake renegotiation, allow the renegotiation to
583       continue nevertheless (i.e. send all the required certificates).
584       Fixes bug 4591; bugfix on 0.2.0.20-rc.
585     - When we receive a SIGHUP and the controller __ReloadTorrcOnSIGHUP
586       option is set to 0 (which Vidalia version 0.2.16 now does when
587       a SAVECONF attempt fails), perform other actions that SIGHUP
588       usually causes (like reopening the logs). Fixes bug 5095; bugfix
589       on 0.2.1.9-alpha.
590     - If we fail to write a microdescriptor to the disk cache, do not
591       continue replacing the old microdescriptor file. Fixes bug 2954;
592       bugfix on 0.2.2.6-alpha.
593     - Exit nodes don't need to fetch certificates for authorities that
594       they don't recognize; only directory authorities, bridges,
595       and caches need to do that. Fixes part of bug 2297; bugfix on
596       0.2.2.11-alpha.
597     - Correctly handle checking the permissions on the parent
598       directory of a control socket in the root directory. Bug found
599       by Esteban Manchado Velázquez. Fixes bug 5089; bugfix on Tor
600       0.2.2.26-beta.
601     - When told to add a bridge with the same digest as a preexisting
602       bridge but a different addr:port, change the addr:port as
603       requested. Previously we would not notice the change. Fixes half
604       of bug 5603; fix on 0.2.2.26-beta.
605     - End AUTHCHALLENGE error messages (in the control protocol) with
606       a CRLF. Fixes bug 5760; bugfix on 0.2.2.36 and 0.2.3.13-alpha.
607
608   o Minor bugfixes (on 0.2.3.x):
609     - Turn an assertion (that the number of handshakes received as a
610       server is not < 1) into a warning. Fixes bug 4873; bugfix on
611       0.2.3.1-alpha.
612     - Format IPv4 addresses correctly in ADDRMAP events. (Previously,
613       we had reversed them when the answer was cached.) Fixes bug
614       5723; bugfix on 0.2.3.1-alpha.
615     - Work correctly on Linux systems with accept4 support advertised in
616       their headers, but without accept4 support in the kernel. Fix
617       by murb. Fixes bug 5762; bugfix on 0.2.3.1-alpha.
618     - When told to add a bridge with the same addr:port as a preexisting
619       bridge but a different transport, change the transport as
620       requested. Previously we would not notice the change. Fixes half
621       of bug 5603; fix on 0.2.3.2-alpha.
622     - Avoid a "double-reply" warning when replying to a SOCKS request
623       with a parse error. Patch from Fabian Keil. Fixes bug 4108;
624       bugfix on 0.2.3.4-alpha.
625     - Fix a bug where a bridge authority crashes if it has seen no
626       directory requests when it's time to write statistics to disk.
627       Fixes bug 5891; bugfix on 0.2.3.6-alpha. Also fixes bug 5508 in
628       a better way.
629     - Don't try to open non-control listeners when DisableNetwork is set.
630       Previously, we'd open all listeners, then immediately close them.
631       Fixes bug 5604; bugfix on 0.2.3.9-alpha.
632     - Don't abort the managed proxy protocol if the managed proxy
633       sends us an unrecognized line; ignore it instead. Fixes bug
634       5910; bugfix on 0.2.3.9-alpha.
635     - Fix a compile warning in crypto.c when compiling with clang 3.1.
636       Fixes bug 5969, bugfix on 0.2.3.9-alpha.
637     - Fix a compilation issue on GNU Hurd, which doesn't have PATH_MAX.
638       Fixes bug 5355; bugfix on 0.2.3.11-alpha.
639     - Remove bogus definition of "_WIN32" from src/win32/orconfig.h, to
640       unbreak the MSVC build. Fixes bug 5858; bugfix on 0.2.3.12-alpha.
641     - Resolve numerous small warnings and build issues with MSVC. Resolves
642       bug 5859.
643
644   o Documentation fixes:
645     - Improve the manual's documentation for the NT Service command-line
646       options. Addresses ticket 3964.
647     - Clarify SessionGroup documentation slightly; resolves ticket 5437.
648     - Document the changes to the ORPort and DirPort options, and the
649       fact that {OR/Dir}ListenAddress is now unnecessary (and
650       therefore deprecated). Resolves ticket 5597.
651
652   o Removed files:
653     - Remove the torrc.bridge file: we don't use it for anything, and
654       it had become badly desynchronized from torrc.sample. Resolves
655       bug 5622.
656
657
658 Changes in version 0.2.2.36 - 2012-05-24
659   Tor 0.2.2.36 updates the addresses for two of the eight directory
660   authorities, fixes some potential anonymity and security issues,
661   and fixes several crash bugs.
662
663   Tor 0.2.1.x has reached its end-of-life. Those Tor versions have many
664   known flaws, and nobody should be using them. You should upgrade. If
665   you're using a Linux or BSD and its packages are obsolete, stop using
666   those packages and upgrade anyway.
667
668   o Directory authority changes:
669     - Change IP address for maatuska (v3 directory authority).
670     - Change IP address for ides (v3 directory authority), and rename
671       it to turtles.
672
673   o Security fixes:
674     - When building or running with any version of OpenSSL earlier
675       than 0.9.8s or 1.0.0f, disable SSLv3 support. These OpenSSL
676       versions have a bug (CVE-2011-4576) in which their block cipher
677       padding includes uninitialized data, potentially leaking sensitive
678       information to any peer with whom they make a SSLv3 connection. Tor
679       does not use SSL v3 by default, but a hostile client or server
680       could force an SSLv3 connection in order to gain information that
681       they shouldn't have been able to get. The best solution here is to
682       upgrade to OpenSSL 0.9.8s or 1.0.0f (or later). But when building
683       or running with a non-upgraded OpenSSL, we disable SSLv3 entirely
684       to make sure that the bug can't happen.
685     - Never use a bridge or a controller-supplied node as an exit, even
686       if its exit policy allows it. Found by wanoskarnet. Fixes bug
687       5342. Bugfix on 0.1.1.15-rc (for controller-purpose descriptors)
688       and 0.2.0.3-alpha (for bridge-purpose descriptors).
689     - Only build circuits if we have a sufficient threshold of the total
690       descriptors that are marked in the consensus with the "Exit"
691       flag. This mitigates an attack proposed by wanoskarnet, in which
692       all of a client's bridges collude to restrict the exit nodes that
693       the client knows about. Fixes bug 5343.
694     - Provide controllers with a safer way to implement the cookie
695       authentication mechanism. With the old method, if another locally
696       running program could convince a controller that it was the Tor
697       process, then that program could trick the controller into telling
698       it the contents of an arbitrary 32-byte file. The new "SAFECOOKIE"
699       authentication method uses a challenge-response approach to prevent
700       this attack. Fixes bug 5185; implements proposal 193.
701
702   o Major bugfixes:
703     - Avoid logging uninitialized data when unable to decode a hidden
704       service descriptor cookie. Fixes bug 5647; bugfix on 0.2.1.5-alpha.
705     - Avoid a client-side assertion failure when receiving an INTRODUCE2
706       cell on a general purpose circuit. Fixes bug 5644; bugfix on
707       0.2.1.6-alpha.
708     - Fix builds when the path to sed, openssl, or sha1sum contains
709       spaces, which is pretty common on Windows. Fixes bug 5065; bugfix
710       on 0.2.2.1-alpha.
711     - Correct our replacements for the timeradd() and timersub() functions
712       on platforms that lack them (for example, Windows). The timersub()
713       function is used when expiring circuits, while timeradd() is
714       currently unused. Bug report and patch by Vektor. Fixes bug 4778;
715       bugfix on 0.2.2.24-alpha.
716     - Fix the SOCKET_OK test that we use to tell when socket
717       creation fails so that it works on Win64. Fixes part of bug 4533;
718       bugfix on 0.2.2.29-beta. Bug found by wanoskarnet.
719
720   o Minor bugfixes:
721     - Reject out-of-range times like 23:59:61 in parse_rfc1123_time().
722       Fixes bug 5346; bugfix on 0.0.8pre3.
723     - Make our number-parsing functions always treat too-large values
724       as an error, even when those values exceed the width of the
725       underlying type. Previously, if the caller provided these
726       functions with minima or maxima set to the extreme values of the
727       underlying integer type, these functions would return those
728       values on overflow rather than treating overflow as an error.
729       Fixes part of bug 5786; bugfix on 0.0.9.
730     - Older Linux kernels erroneously respond to strange nmap behavior
731       by having accept() return successfully with a zero-length
732       socket. When this happens, just close the connection. Previously,
733       we would try harder to learn the remote address: but there was
734       no such remote address to learn, and our method for trying to
735       learn it was incorrect. Fixes bugs 1240, 4745, and 4747. Bugfix
736       on 0.1.0.3-rc. Reported and diagnosed by "r1eo".
737     - Correct parsing of certain date types in parse_http_time().
738       Without this patch, If-Modified-Since would behave
739       incorrectly. Fixes bug 5346; bugfix on 0.2.0.2-alpha. Patch from
740       Esteban Manchado Velázques.
741     - Change the BridgePassword feature (part of the "bridge community"
742       design, which is not yet implemented) to use a time-independent
743       comparison. The old behavior might have allowed an adversary
744       to use timing to guess the BridgePassword value. Fixes bug 5543;
745       bugfix on 0.2.0.14-alpha.
746     - Detect and reject certain misformed escape sequences in
747       configuration values. Previously, these values would cause us
748       to crash if received in a torrc file or over an authenticated
749       control port. Bug found by Esteban Manchado Velázquez, and
750       independently by Robert Connolly from Matta Consulting who further
751       noted that it allows a post-authentication heap overflow. Patch
752       by Alexander Schrijver. Fixes bugs 5090 and 5402 (CVE 2012-1668);
753       bugfix on 0.2.0.16-alpha.
754     - Fix a compile warning when using the --enable-openbsd-malloc
755       configure option. Fixes bug 5340; bugfix on 0.2.0.20-rc.
756     - During configure, detect when we're building with clang version
757       3.0 or lower and disable the -Wnormalized=id and -Woverride-init
758       CFLAGS. clang doesn't support them yet.
759     - When sending an HTTP/1.1 proxy request, include a Host header.
760       Fixes bug 5593; bugfix on 0.2.2.1-alpha.
761     - Fix a NULL-pointer dereference on a badly formed SETCIRCUITPURPOSE
762       command. Found by mikeyc. Fixes bug 5796; bugfix on 0.2.2.9-alpha.
763     - If we hit the error case where routerlist_insert() replaces an
764       existing (old) server descriptor, make sure to remove that
765       server descriptor from the old_routers list. Fix related to bug
766       1776. Bugfix on 0.2.2.18-alpha.
767
768   o Minor bugfixes (documentation and log messages):
769     - Fix a typo in a log message in rend_service_rendezvous_has_opened().
770       Fixes bug 4856; bugfix on Tor 0.0.6.
771     - Update "ClientOnly" man page entry to explain that there isn't
772       really any point to messing with it. Resolves ticket 5005.
773     - Document the GiveGuardFlagTo_CVE_2011_2768_VulnerableRelays
774       directory authority option (introduced in Tor 0.2.2.34).
775     - Downgrade the "We're missing a certificate" message from notice
776       to info: people kept mistaking it for a real problem, whereas it
777       is seldom the problem even when we are failing to bootstrap. Fixes
778       bug 5067; bugfix on 0.2.0.10-alpha.
779     - Correctly spell "connect" in a log message on failure to create a
780       controlsocket. Fixes bug 4803; bugfix on 0.2.2.26-beta.
781     - Clarify the behavior of MaxCircuitDirtiness with hidden service
782       circuits. Fixes issue 5259.
783
784   o Minor features:
785     - Directory authorities now reject versions of Tor older than
786       0.2.1.30, and Tor versions between 0.2.2.1-alpha and 0.2.2.20-alpha
787       inclusive. These versions accounted for only a small fraction of
788       the Tor network, and have numerous known security issues. Resolves
789       issue 4788.
790     - Update to the May 1 2012 Maxmind GeoLite Country database.
791
792   - Feature removal:
793     - When sending or relaying a RELAY_EARLY cell, we used to convert
794       it to a RELAY cell if the connection was using the v1 link
795       protocol. This was a workaround for older versions of Tor, which
796       didn't handle RELAY_EARLY cells properly. Now that all supported
797       versions can handle RELAY_EARLY cells, and now that we're enforcing
798       the "no RELAY_EXTEND commands except in RELAY_EARLY cells" rule,
799       remove this workaround. Addresses bug 4786.
800
801
802 Changes in version 0.2.3.15-alpha - 2012-04-30
803   Tor 0.2.3.15-alpha fixes a variety of smaller bugs, including making
804   the development branch build on Windows again.
805
806   o Minor bugfixes (on 0.2.2.x and earlier):
807     - Make sure that there are no unhandled pending TLS errors before
808       reading from a TLS stream. We had checks in 0.1.0.3-rc, but
809       lost them in 0.1.0.5-rc when we refactored read_to_buf_tls().
810       Bugfix on 0.1.0.5-rc; fixes bug 4528.
811     - Fix an assert that directory authorities could trigger on sighup
812       during some configuration state transitions. We now don't treat
813       it as a fatal error when the new descriptor we just generated in
814       init_keys() isn't accepted. Fixes bug 4438; bugfix on 0.2.1.9-alpha.
815     - After we pick a directory mirror, we would refuse to use it if
816       it's in our ExcludeExitNodes list, resulting in mysterious failures
817       to bootstrap for people who just wanted to avoid exiting from
818       certain locations. Fixes bug 5623; bugfix on 0.2.2.25-alpha.
819     - When building with --enable-static-tor on OpenBSD, do not
820       erroneously attempt to link -lrt. Fixes bug 5103.
821
822   o Minor bugfixes (on 0.2.3.x):
823     - When Tor is built with kernel headers from a recent (last few
824       years) Linux kernel, do not fail to run on older (pre-2.6.28
825       Linux kernels). Fixes bug 5112; bugfix on 0.2.3.1-alpha.
826     - Fix cross-compilation issues with mingw. Bugfixes on 0.2.3.6-alpha
827       and 0.2.3.12-alpha.
828     - Fix compilation with miniupnpc version 1.6; patch from
829       Anthony G. Basile. Fixes bug 5434; bugfix on 0.2.3.12-alpha.
830     - Fix compilation with MSVC, which had defined MS_WINDOWS. Bugfix
831       on 0.2.3.13-alpha; found and fixed by Gisle Vanem.
832     - Fix compilation on platforms without unistd.h, or where environ
833       is defined in stdlib.h. Fixes bug 5704; bugfix on 0.2.3.13-alpha.
834
835   o Minor features:
836     - Directory authorities are now a little more lenient at accepting
837       older router descriptors, or newer router descriptors that don't
838       make big changes. This should help ameliorate past and future
839       issues where routers think they have uploaded valid descriptors,
840       but the authorities don't think so. Fix for ticket 2479.
841     - Make the code that clients use to detect an address change be
842       IPv6-aware, so that it won't fill clients' logs with error
843       messages when trying to get the IPv4 address of an IPv6
844       connection. Implements ticket 5537.
845
846   o Removed features:
847     - Remove the GiveGuardFlagTo_CVE_2011_2768_VulnerableRelays option;
848       authorities needed to use it for a while to keep the network working
849       as people upgraded to 0.2.1.31, 0.2.2.34, or 0.2.3.6-alpha, but
850       that was six months ago. As of now, it should no longer be needed
851       or used.
852
853
854 Changes in version 0.2.3.14-alpha - 2012-04-23
855   Tor 0.2.3.14-alpha fixes yet more bugs to get us closer to a release
856   candidate. It also dramatically speeds up AES: fast relays should
857   consider switching to the newer OpenSSL library.
858
859   o Directory authority changes:
860     - Change IP address for ides (v3 directory authority), and rename
861       it to turtles.
862
863   o Major bugfixes:
864     - Avoid logging uninitialized data when unable to decode a hidden
865       service descriptor cookie. Fixes bug 5647; bugfix on 0.2.1.5-alpha.
866     - Avoid a client-side assertion failure when receiving an INTRODUCE2
867       cell on a general purpose circuit. Fixes bug 5644; bugfix on
868       0.2.1.6-alpha.
869     - If authorities are unable to get a v2 consensus document from other
870       directory authorities, they no longer fall back to fetching
871       them from regular directory caches. Fixes bug 5635; bugfix on
872       0.2.2.26-beta, where routers stopped downloading v2 consensus
873       documents entirely.
874     - When we start a Tor client with a normal consensus already cached,
875       be willing to download a microdescriptor consensus. Fixes bug 4011;
876       fix on 0.2.3.1-alpha.
877
878   o Major features (performance):
879     - When built to use OpenSSL 1.0.1, and built for an x86 or x86_64
880       instruction set, take advantage of OpenSSL's AESNI, bitsliced, or
881       vectorized AES implementations as appropriate. These can be much,
882       much faster than other AES implementations.
883
884   o Minor bugfixes (0.2.2.x and earlier):
885     - Don't launch more than 10 service-side introduction-point circuits
886       for a hidden service in five minutes. Previously, we would consider
887       launching more introduction-point circuits if at least one second
888       had passed without any introduction-point circuits failing. Fixes
889       bug 4607; bugfix on 0.0.7pre1.
890     - Change the BridgePassword feature (part of the "bridge community"
891       design, which is not yet implemented) to use a time-independent
892       comparison. The old behavior might have allowed an adversary
893       to use timing to guess the BridgePassword value. Fixes bug 5543;
894       bugfix on 0.2.0.14-alpha.
895     - Enforce correct return behavior of tor_vsscanf() when the '%%'
896       pattern is used. Fixes bug 5558. Bugfix on 0.2.1.13.
897     - When sending an HTTP/1.1 proxy request, include a Host header.
898       Fixes bug 5593; bugfix on 0.2.2.1-alpha.
899     - Don't log that we have "decided to publish new relay descriptor"
900       unless we are actually publishing a descriptor. Fixes bug 3942;
901       bugfix on 0.2.2.28-beta.
902
903   o Minor bugfixes (0.2.3.x):
904     - Fix a bug where a bridge authority crashes (on a failed assert)
905       if it has seen no directory requests when it's time to write
906       statistics to disk. Fixes bug 5508. Bugfix on 0.2.3.6-alpha.
907     - Fix bug stomping on ORPort option NoListen and ignoring option
908       NoAdvertise. Fixes bug 5151; bugfix on 0.2.3.9-alpha.
909     - In the testsuite, provide a large enough buffer in the tor_sscanf
910       unit test. Otherwise we'd overrun that buffer and crash during
911       the unit tests. Found by weasel. Fixes bug 5449; bugfix on
912       0.2.3.12-alpha.
913     - Make sure we create the keys directory if it doesn't exist and we're
914       about to store the dynamic Diffie-Hellman parameters. Fixes bug
915       5572; bugfix on 0.2.3.13-alpha.
916     - Fix a small memory leak when trying to decode incorrect base16
917       authenticator during SAFECOOKIE authentication. Found by
918       Coverity Scan. Fixes CID 507. Bugfix on 0.2.3.13-alpha.
919
920   o Minor features:
921     - Add more information to a log statement that might help track down
922       bug 4091. If you're seeing "Bug: tor_addr_is_internal() called with a
923       non-IP address" messages (or any Bug messages, for that matter!),
924       please let us know about it.
925     - Relays now understand an IPv6 address when they get one from a
926       directory server. Resolves ticket 4875.
927     - Resolve IPv6 addresses in bridge and entry statistics to country
928       code "??" which means we at least count them. Resolves ticket 5053;
929       improves on 0.2.3.9-alpha.
930     - Update to the April 3 2012 Maxmind GeoLite Country database.
931     - Begin a doc/state-contents.txt file to explain the contents of
932       the Tor state file. Fixes bug 2987.
933
934   o Default torrc changes:
935     - Stop listing "socksport 9050" in torrc.sample. We open a socks
936       port on 9050 by default anyway, so this should not change anything
937       in practice.
938     - Stop mentioning the deprecated *ListenAddress options in
939       torrc.sample. Fixes bug 5438.
940     - Document unit of bandwidth related options in sample torrc.
941       Fixes bug 5621.
942
943   o Removed features:
944     - The "torify" script no longer supports the "tsocks" socksifier
945       tool, since tsocks doesn't support DNS and UDP right for Tor.
946       Everyone should be using torsocks instead. Fixes bugs 3530 and
947       5180. Based on a patch by "ugh".
948
949   o Code refactoring:
950     - Change the symmetric cipher interface so that creating and
951       initializing a stream cipher are no longer separate functions.
952     - Remove all internal support for unpadded RSA. We never used it, and
953       it would be a bad idea to start.
954
955
956 Changes in version 0.2.3.13-alpha - 2012-03-26
957   Tor 0.2.3.13-alpha fixes a variety of stability and correctness bugs
958   in managed pluggable transports, as well as providing other cleanups
959   that get us closer to a release candidate.
960
961   o Directory authority changes:
962     - Change IP address for maatuska (v3 directory authority).
963
964   o Security fixes:
965     - Provide controllers with a safer way to implement the cookie
966       authentication mechanism. With the old method, if another locally
967       running program could convince a controller that it was the Tor
968       process, then that program could trick the controller into telling
969       it the contents of an arbitrary 32-byte file. The new "SAFECOOKIE"
970       authentication method uses a challenge-response approach to prevent
971       this attack. Fixes bug 5185, implements proposal 193.
972     - Never use a bridge or a controller-supplied node as an exit, even
973       if its exit policy allows it. Found by wanoskarnet. Fixes bug
974       5342. Bugfix on 0.1.1.15-rc (for controller-purpose descriptors)
975       and 0.2.0.3-alpha (for bridge-purpose descriptors).
976     - Only build circuits if we have a sufficient threshold of the total
977       descriptors that are marked in the consensus with the "Exit"
978       flag. This mitigates an attack proposed by wanoskarnet, in which
979       all of a client's bridges collude to restrict the exit nodes that
980       the client knows about. Fixes bug 5343.
981
982   o Major bugfixes (on Tor 0.2.3.x):
983     - Avoid an assert when managed proxies like obfsproxy are configured,
984       and we receive HUP signals or setconf attempts too rapidly. This
985       situation happens most commonly when Vidalia tries to attach to
986       Tor or tries to configure the Tor it's attached to. Fixes bug 5084;
987       bugfix on 0.2.3.6-alpha.
988     - Fix a relay-side pluggable transports bug where managed proxies were
989       unreachable from the Internet, because Tor asked them to bind on
990       localhost. Fixes bug 4725; bugfix on 0.2.3.9-alpha.
991     - Stop discarding command-line arguments when TestingTorNetwork
992       is set. Discovered by Kevin Bauer. Fixes bug 5373; bugfix on
993       0.2.3.9-alpha, where task 4552 added support for two layers of
994       torrc files.
995     - Resume allowing the unit tests to run in gdb. This was accidentally
996       made impossible when the DisableDebuggerAttachment option was
997       introduced. Fixes bug 5448; bugfix on 0.2.3.9-alpha.
998     - Resume building with nat-pmp support. Fixes bug 4955; bugfix on
999       0.2.3.11-alpha. Reported by Anthony G. Basile.
1000
1001   o Minor bugfixes (on 0.2.2.x and earlier):
1002     - Ensure we don't cannibalize circuits that are longer than three hops
1003       already, so we don't end up making circuits with 5 or more
1004       hops. Patch contributed by wanoskarnet. Fixes bug 5231; bugfix on
1005       0.1.0.1-rc which introduced cannibalization.
1006     - Detect and reject certain misformed escape sequences in
1007       configuration values. Previously, these values would cause us
1008       to crash if received in a torrc file or over an authenticated
1009       control port. Bug found by Esteban Manchado Velázquez, and
1010       independently by Robert Connolly from Matta Consulting who further
1011       noted that it allows a post-authentication heap overflow. Patch
1012       by Alexander Schrijver. Fixes bugs 5090 and 5402 (CVE 2012-1668);
1013       bugfix on 0.2.0.16-alpha.
1014     - Fix a compile warning when using the --enable-openbsd-malloc
1015       configure option. Fixes bug 5340; bugfix on 0.2.0.20-rc.
1016     - Directory caches no longer refuse to clean out descriptors because
1017       of missing v2 networkstatus documents, unless they're configured
1018       to retrieve v2 networkstatus documents. Fixes bug 4838; bugfix on
1019       0.2.2.26-beta. Patch by Daniel Bryg.
1020     - Update to the latest version of the tinytest unit testing framework.
1021       This includes a couple of bugfixes that can be relevant for
1022       running forked unit tests on Windows, and removes all reserved
1023       identifiers.
1024
1025   o Minor bugfixes (on 0.2.3.x):
1026     - On a failed pipe() call, don't leak file descriptors. Fixes bug
1027       4296; bugfix on 0.2.3.1-alpha.
1028     - Spec conformance: on a v3 handshake, do not send a NETINFO cell
1029       until after we have received a CERTS cell. Fixes bug 4361; bugfix
1030       on 0.2.3.6-alpha. Patch by "frosty".
1031     - When binding to an IPv6 address, set the IPV6_V6ONLY socket
1032       option, so that the IP stack doesn't decide to use it for IPv4
1033       too. Fixes bug 4760; bugfix on 0.2.3.9-alpha.
1034     - Ensure that variables set in Tor's environment cannot override
1035       environment variables that Tor passes to a managed
1036       pluggable-transport proxy. Previously, Tor would pass every
1037       variable in its environment to managed proxies along with the new
1038       ones, in such a way that on many operating systems, the inherited
1039       environment variables would override those which Tor tried to
1040       explicitly set. Bugfix on 0.2.3.12-alpha for most Unixoid systems;
1041       bugfix on 0.2.3.9-alpha for Windows.
1042
1043   o Minor features:
1044     - A wide variety of new unit tests by Esteban Manchado Velázquez.
1045     - Shorten links in the tor-exit-notice file. Patch by Christian Kujau.
1046     - Update to the March 6 2012 Maxmind GeoLite Country database.
1047
1048
1049 Changes in version 0.2.3.12-alpha - 2012-02-13
1050   Tor 0.2.3.12-alpha lets fast exit relays scale better, allows clients
1051   to use bridges that run Tor 0.2.2.x, and resolves several big bugs
1052   when Tor is configured to use a pluggable transport like obfsproxy.
1053
1054   o Major bugfixes:
1055     - Fix builds when the path to sed, openssl, or sha1sum contains
1056       spaces, which is pretty common on Windows. Fixes bug 5065; bugfix
1057       on 0.2.2.1-alpha.
1058     - Set the SO_REUSEADDR socket option before we call bind() on outgoing
1059       connections. This change should allow busy exit relays to stop
1060       running out of available sockets as quickly. Fixes bug 4950;
1061       bugfix on 0.2.2.26-beta.
1062     - Allow 0.2.3.x clients to use 0.2.2.x bridges. Previously the client
1063       would ask the bridge for microdescriptors, which are only supported
1064       in 0.2.3.x, and then fail to bootstrap when it didn't get the
1065       answers it wanted. Fixes bug 4013; bugfix on 0.2.3.2-alpha.
1066     - Properly set up obfsproxy's environment when in managed mode. The
1067       Tor Browser Bundle needs LD_LIBRARY_PATH to be passed to obfsproxy,
1068       and when you run your Tor as a daemon, there's no HOME. Fixes bugs
1069       5076 and 5082; bugfix on 0.2.3.6-alpha.
1070
1071   o Minor features:
1072     - Use the dead_strip option when building Tor on OS X. This reduces
1073       binary size by almost 19% when linking openssl and libevent
1074       statically, which we do for Tor Browser Bundle.
1075     - Fix broken URLs in the sample torrc file, and tell readers about
1076       the OutboundBindAddress, ExitPolicyRejectPrivate, and
1077       PublishServerDescriptor options. Addresses bug 4652.
1078     - Update to the February 7 2012 Maxmind GeoLite Country database.
1079
1080   o Minor bugfixes:
1081     - Downgrade the "We're missing a certificate" message from notice
1082       to info: people kept mistaking it for a real problem, whereas it
1083       is seldom the problem even when we are failing to bootstrap. Fixes
1084       bug 5067; bugfix on 0.2.0.10-alpha.
1085     - Don't put "TOR_PT_EXTENDED_SERVER_PORT=127.0.0.1:4200" in a
1086       managed pluggable transport server proxy's environment.
1087       Previously, we would put it there, even though Tor doesn't
1088       implement an 'extended server port' yet, and even though Tor
1089       almost certainly isn't listening at that address. For now, we set
1090       it to an empty string to avoid crashing older obfsproxies. Bugfix
1091       on 0.2.3.6-alpha.
1092     - Log the heartbeat message every HeartbeatPeriod seconds, not every
1093       HeartbeatPeriod + 1 seconds. Fixes bug 4942; bugfix on
1094       0.2.3.1-alpha. Bug reported by Scott Bennett.
1095     - Calculate absolute paths correctly on Windows. Fixes bug 4973;
1096       bugfix on 0.2.3.11-alpha.
1097     - Update "ClientOnly" man page entry to explain that there isn't
1098       really any point to messing with it. Resolves ticket 5005.
1099     - Use the correct CVE number for CVE-2011-4576 in our comments and
1100       log messages. Found by "fermenthor". Resolves bug 5066; bugfix on
1101       0.2.3.11-alpha.
1102
1103   o Code simplifications and refactoring:
1104     - Use the _WIN32 macro throughout our code to detect Windows.
1105       (Previously we had used the obsolete 'WIN32' and the idiosyncratic
1106       'MS_WINDOWS'.)
1107
1108
1109 Changes in version 0.2.3.11-alpha - 2012-01-22
1110   Tor 0.2.3.11-alpha marks feature-freeze for the 0.2.3 tree. It deploys
1111   the last step of the plan to limit maximum circuit length, includes
1112   a wide variety of hidden service performance and correctness fixes,
1113   works around an OpenSSL security flaw if your distro is too stubborn
1114   to upgrade, and fixes a bunch of smaller issues.
1115
1116   o Major features:
1117     - Now that Tor 0.2.0.x is completely deprecated, enable the final
1118       part of "Proposal 110: Avoiding infinite length circuits" by
1119       refusing all circuit-extend requests that do not use a relay_early
1120       cell. This change helps Tor resist a class of denial-of-service
1121       attacks by limiting the maximum circuit length.
1122     - Adjust the number of introduction points that a hidden service
1123       will try to maintain based on how long its introduction points
1124       remain in use and how many introductions they handle. Fixes
1125       part of bug 3825.
1126     - Try to use system facilities for enumerating local interface
1127       addresses, before falling back to our old approach (which was
1128       binding a UDP socket, and calling getsockname() on it). That
1129       approach was scaring OS X users whose draconian firewall
1130       software warned about binding to UDP sockets, regardless of
1131       whether packets were sent. Now we try to use getifaddrs(),
1132       SIOCGIFCONF, or GetAdaptersAddresses(), depending on what the
1133       system supports. Resolves ticket 1827.
1134
1135   o Major security workaround:
1136     - When building or running with any version of OpenSSL earlier
1137       than 0.9.8s or 1.0.0f, disable SSLv3 support. These OpenSSL
1138       versions have a bug (CVE-2011-4576) in which their block cipher
1139       padding includes uninitialized data, potentially leaking sensitive
1140       information to any peer with whom they make a SSLv3 connection. Tor
1141       does not use SSL v3 by default, but a hostile client or server
1142       could force an SSLv3 connection in order to gain information that
1143       they shouldn't have been able to get. The best solution here is to
1144       upgrade to OpenSSL 0.9.8s or 1.0.0f (or later). But when building
1145       or running with a non-upgraded OpenSSL, we disable SSLv3 entirely
1146       to make sure that the bug can't happen.
1147
1148   o Major bugfixes:
1149     - Fix the SOCKET_OK test that we use to tell when socket
1150       creation fails so that it works on Win64. Fixes part of bug 4533;
1151       bugfix on 0.2.2.29-beta. Bug found by wanoskarnet.
1152     - Correct our replacements for the timeradd() and timersub() functions
1153       on platforms that lack them (for example, Windows). The timersub()
1154       function is used when expiring circuits, while timeradd() is
1155       currently unused. Bug report and patch by Vektor. Fixes bug 4778;
1156       bugfix on 0.2.2.24-alpha and 0.2.3.1-alpha.
1157     - Do not use OpenSSL 1.0.0's counter mode: it has a critical bug
1158       that was fixed in OpenSSL 1.0.0a. We test for the counter mode
1159       bug at runtime, not compile time, because some distributions hack
1160       their OpenSSL to mis-report its version. Fixes bug 4779; bugfix
1161       on 0.2.3.9-alpha. Found by Pascal.
1162
1163   o Minor features (controller):
1164     - Use absolute path names when reporting the torrc filename in the
1165       control protocol, so a controller can more easily find the torrc
1166       file. Resolves bug 1101.
1167     - Extend the control protocol to report flags that control a circuit's
1168       path selection in CIRC events and in replies to 'GETINFO
1169       circuit-status'. Implements part of ticket 2411.
1170     - Extend the control protocol to report the hidden service address
1171       and current state of a hidden-service-related circuit in CIRC
1172       events and in replies to 'GETINFO circuit-status'. Implements part
1173       of ticket 2411.
1174     - When reporting the path to the cookie file to the controller,
1175       give an absolute path. Resolves ticket 4881.
1176     - Allow controllers to request an event notification whenever a
1177       circuit is cannibalized or its purpose is changed. Implements
1178       part of ticket 3457.
1179     - Include the creation time of a circuit in CIRC and CIRC2
1180       control-port events and the list produced by the 'GETINFO
1181       circuit-status' control-port command.
1182
1183   o Minor features (directory authorities):
1184     - Directory authorities now reject versions of Tor older than
1185       0.2.1.30, and Tor versions between 0.2.2.1-alpha and 0.2.2.20-alpha
1186       inclusive. These versions accounted for only a small fraction of
1187       the Tor network, and have numerous known security issues. Resolves
1188       issue 4788.
1189     - Authority operators can now vote for all relays in a given
1190       set of countries to be BadDir/BadExit/Invalid/Rejected.
1191     - Provide two consensus parameters (FastFlagMinThreshold and
1192       FastFlagMaxThreshold) to control the range of allowable bandwidths
1193       for the Fast directory flag. These allow authorities to run
1194       experiments on appropriate requirements for being a "Fast" node.
1195       The AuthDirFastGuarantee config value still applies.
1196     - Document the GiveGuardFlagTo_CVE_2011_2768_VulnerableRelays
1197       directory authority option (introduced in Tor 0.2.2.34).
1198
1199   o Minor features (other):
1200     - Don't disable the DirPort when we cannot exceed our AccountingMax
1201       limit during this interval because the effective bandwidthrate is
1202       low enough. This is useful in a situation where AccountMax is only
1203       used as an additional safeguard or to provide statistics.
1204     - Prepend an informative header to generated dynamic_dh_params files.
1205     - If EntryNodes are given, but UseEntryGuards is set to 0, warn that
1206       EntryNodes will have no effect. Resolves issue 2571.
1207     - Log more useful messages when we fail to disable debugger
1208       attachment.
1209     - Log which authority we're missing votes from when we go to fetch
1210       them from the other auths.
1211     - Log (at debug level) whenever a circuit's purpose is changed.
1212     - Add missing documentation for the MaxClientCircuitsPending,
1213       UseMicrodescriptors, UserspaceIOCPBuffers, and
1214       _UseFilteringSSLBufferevents options, all introduced during
1215       the 0.2.3.x series.
1216     - Update to the January 3 2012 Maxmind GeoLite Country database.
1217
1218   o Minor bugfixes (hidden services):
1219     - Don't close hidden service client circuits which have almost
1220       finished connecting to their destination when they reach
1221       the normal circuit-build timeout. Previously, we would close
1222       introduction circuits which are waiting for an acknowledgement
1223       from the introduction point, and rendezvous circuits which have
1224       been specified in an INTRODUCE1 cell sent to a hidden service,
1225       after the normal CBT. Now, we mark them as 'timed out', and launch
1226       another rendezvous attempt in parallel. This behavior change can
1227       be disabled using the new CloseHSClientCircuitsImmediatelyOnTimeout
1228       option. Fixes part of bug 1297; bugfix on 0.2.2.2-alpha.
1229     - Don't close hidden-service-side rendezvous circuits when they
1230       reach the normal circuit-build timeout. This behaviour change can
1231       be disabled using the new
1232       CloseHSServiceRendCircuitsImmediatelyOnTimeout option. Fixes the
1233       remaining part of bug 1297; bugfix on 0.2.2.2-alpha.
1234     - Make sure we never mark the wrong rendezvous circuit as having
1235       had its introduction cell acknowleged by the introduction-point
1236       relay. Previously, when we received an INTRODUCE_ACK cell on a
1237       client-side hidden-service introduction circuit, we might have
1238       marked a rendezvous circuit other than the one we specified in
1239       the INTRODUCE1 cell as INTRO_ACKED, which would have produced
1240       a warning message and interfered with the hidden service
1241       connection-establishment process. Fixes bug 4759; bugfix on
1242       0.2.3.3-alpha, when we added the stream-isolation feature which
1243       might cause Tor to open multiple rendezvous circuits for the same
1244       hidden service.
1245     - Don't trigger an assertion failure when we mark a new client-side
1246       hidden-service introduction circuit for close during the process
1247       of creating it. Fixes bug 4796; bugfix on 0.2.3.6-alpha. Reported
1248       by murb.
1249
1250   o Minor bugfixes (log messages):
1251     - Correctly spell "connect" in a log message on failure to create a
1252       controlsocket. Fixes bug 4803; bugfix on 0.2.2.26-beta and
1253       0.2.3.2-alpha.
1254     - Fix a typo in a log message in rend_service_rendezvous_has_opened().
1255       Fixes bug 4856; bugfix on Tor 0.0.6.
1256     - Fix the log message describing how we work around discovering
1257       that our version is the ill-fated OpenSSL 0.9.8l. Fixes bug
1258       4837; bugfix on 0.2.2.9-alpha.
1259     - When logging about a disallowed .exit name, do not also call it
1260       an "invalid onion address". Fixes bug 3325; bugfix on 0.2.2.9-alpha.
1261
1262   o Minor bugfixes (build fixes):
1263     - During configure, detect when we're building with clang version
1264       3.0 or lower and disable the -Wnormalized=id and -Woverride-init
1265       CFLAGS. clang doesn't support them yet.
1266     - During configure, search for library containing cos function as
1267       libm lives in libcore on some platforms (BeOS/Haiku). Linking
1268       against libm was hard-coded before. Fixes the first part of bug
1269       4727; bugfix on 0.2.2.2-alpha. Patch and analysis by Martin Hebnes
1270       Pedersen.
1271     - Detect attempts to build Tor on (as yet hypothetical) versions
1272       of Windows where sizeof(intptr_t) != sizeof(SOCKET). Partial
1273       fix for bug 4533. Bugfix on 0.2.2.28-beta.
1274     - Preprocessor directives should not be put inside the arguments
1275       of a macro. This would break compilation with GCC releases prior
1276       to version 3.3. We would never recommend such an old GCC version,
1277       but it is apparently required for binary compatibility on some
1278       platforms (namely, certain builds of Haiku). Fixes the other part
1279       of bug 4727; bugfix on 0.2.3.3-alpha. Patch and analysis by Martin
1280       Hebnes Pedersen.
1281
1282   o Minor bugfixes (other):
1283     - Older Linux kernels erroneously respond to strange nmap behavior
1284       by having accept() return successfully with a zero-length
1285       socket. When this happens, just close the connection. Previously,
1286       we would try harder to learn the remote address: but there was
1287       no such remote address to learn, and our method for trying to
1288       learn it was incorrect. Fixes bugs 1240, 4745, and 4747. Bugfix
1289       on 0.1.0.3-rc. Reported and diagnosed by "r1eo".
1290     - Fix null-pointer access that could occur if TLS allocation failed.
1291       Fixes bug 4531; bugfix on 0.2.0.20-rc. Found by "troll_un". This was
1292       erroneously listed as fixed in 0.2.3.9-alpha, but the fix had
1293       accidentally been reverted.
1294     - Fix our implementation of crypto_random_hostname() so it can't
1295       overflow on ridiculously large inputs. (No Tor version has ever
1296       provided this kind of bad inputs, but let's be correct in depth.)
1297       Fixes bug 4413; bugfix on 0.2.2.9-alpha. Fix by Stephen Palmateer.
1298     - Find more places in the code that should have been testing for
1299       invalid sockets using the SOCKET_OK macro. Required for a fix
1300       for bug 4533. Bugfix on 0.2.2.28-beta.
1301     - Fix an assertion failure when, while running with bufferevents, a
1302       connection finishes connecting after it is marked for close, but
1303       before it is closed. Fixes bug 4697; bugfix on 0.2.3.1-alpha.
1304     - test_util_spawn_background_ok() hardcoded the expected value
1305       for ENOENT to 2. This isn't portable as error numbers are
1306       platform specific, and particularly the hurd has ENOENT at
1307       0x40000002. Construct expected string at runtime, using the correct
1308       value for ENOENT. Fixes bug 4733; bugfix on 0.2.3.1-alpha.
1309     - Reject attempts to disable DisableDebuggerAttachment while Tor is
1310       running. Fixes bug 4650; bugfix on 0.2.3.9-alpha.
1311     - Use an appropriate-width type for sockets in tor-fw-helper on
1312       win64. Fixes bug 1983 at last. Bugfix on 0.2.3.9-alpha.
1313
1314   o Feature removal:
1315     - When sending or relaying a RELAY_EARLY cell, we used to convert
1316       it to a RELAY cell if the connection was using the v1 link
1317       protocol. This was a workaround for older versions of Tor, which
1318       didn't handle RELAY_EARLY cells properly. Now that all supported
1319       versions can handle RELAY_EARLY cells, and now that we're enforcing
1320       the "no RELAY_EXTEND commands except in RELAY_EARLY cells" rule,
1321       remove this workaround. Addresses bug 4786.
1322
1323   o Code simplifications and refactoring:
1324     - Use OpenSSL's built-in SSL_state_string_long() instead of our
1325       own homebrewed ssl_state_to_string() replacement. Patch from
1326       Emile Snyder. Fixes bug 4653.
1327     - Use macros to indicate OpenSSL versions, so we don't need to worry
1328       about accidental hexadecimal bit shifts.
1329     - Remove some workaround code for OpenSSL 0.9.6 (which is no longer
1330       supported).
1331     - Convert more instances of tor_snprintf+tor_strdup into tor_asprintf.
1332     - Use the smartlist_add_asprintf() alias more consistently.
1333     - Use a TOR_INVALID_SOCKET macro when initializing a socket to an
1334       invalid value, rather than just -1.
1335     - Rename a handful of old identifiers, mostly related to crypto
1336       structures and crypto functions. By convention, our "create an
1337       object" functions are called "type_new()", our "free an object"
1338       functions are called "type_free()", and our types indicate that
1339       they are types only with a final "_t". But a handful of older
1340       types and functions broke these rules, with function names like
1341       "type_create" or "subsystem_op_type", or with type names like
1342       type_env_t.
1343
1344
1345 Changes in version 0.2.3.10-alpha - 2011-12-16
1346   Tor 0.2.3.10-alpha fixes a critical heap-overflow security issue in
1347   Tor's buffers code. Absolutely everybody should upgrade.
1348
1349   The bug relied on an incorrect calculation when making data continuous
1350   in one of our IO buffers, if the first chunk of the buffer was
1351   misaligned by just the wrong amount. The miscalculation would allow an
1352   attacker to overflow a piece of heap-allocated memory. To mount this
1353   attack, the attacker would need to either open a SOCKS connection to
1354   Tor's SocksPort (usually restricted to localhost), or target a Tor
1355   instance configured to make its connections through a SOCKS proxy
1356   (which Tor does not do by default).
1357
1358   Good security practice requires that all heap-overflow bugs should be
1359   presumed to be exploitable until proven otherwise, so we are treating
1360   this as a potential code execution attack. Please upgrade immediately!
1361   This bug does not affect bufferevents-based builds of Tor. Special
1362   thanks to "Vektor" for reporting this issue to us!
1363
1364   This release also contains a few minor bugfixes for issues discovered
1365   in 0.2.3.9-alpha.
1366
1367   o Major bugfixes:
1368     - Fix a heap overflow bug that could occur when trying to pull
1369       data into the first chunk of a buffer, when that chunk had
1370       already had some data drained from it. Fixes CVE-2011-2778;
1371       bugfix on 0.2.0.16-alpha. Reported by "Vektor".
1372
1373   o Minor bugfixes:
1374     - If we can't attach streams to a rendezvous circuit when we
1375       finish connecting to a hidden service, clear the rendezvous
1376       circuit's stream-isolation state and try to attach streams
1377       again. Previously, we cleared rendezvous circuits' isolation
1378       state either too early (if they were freshly built) or not at all
1379       (if they had been built earlier and were cannibalized). Bugfix on
1380       0.2.3.3-alpha; fixes bug 4655.
1381     - Fix compilation of the libnatpmp helper on non-Windows. Bugfix on
1382       0.2.3.9-alpha; fixes bug 4691. Reported by Anthony G. Basile.
1383     - Fix an assertion failure when a relay with accounting enabled
1384       starts up while dormant. Fixes bug 4702; bugfix on 0.2.3.9-alpha.
1385
1386   o Minor features:
1387     - Update to the December 6 2011 Maxmind GeoLite Country database.
1388
1389
1390 Changes in version 0.2.2.35 - 2011-12-16
1391   Tor 0.2.2.35 fixes a critical heap-overflow security issue in Tor's
1392   buffers code. Absolutely everybody should upgrade.
1393
1394   The bug relied on an incorrect calculation when making data continuous
1395   in one of our IO buffers, if the first chunk of the buffer was
1396   misaligned by just the wrong amount. The miscalculation would allow an
1397   attacker to overflow a piece of heap-allocated memory. To mount this
1398   attack, the attacker would need to either open a SOCKS connection to
1399   Tor's SocksPort (usually restricted to localhost), or target a Tor
1400   instance configured to make its connections through a SOCKS proxy
1401   (which Tor does not do by default).
1402
1403   Good security practice requires that all heap-overflow bugs should be
1404   presumed to be exploitable until proven otherwise, so we are treating
1405   this as a potential code execution attack. Please upgrade immediately!
1406   This bug does not affect bufferevents-based builds of Tor. Special
1407   thanks to "Vektor" for reporting this issue to us!
1408
1409   Tor 0.2.2.35 also fixes several bugs in previous versions, including
1410   crash bugs for unusual configurations, and a long-term bug that
1411   would prevent Tor from starting on Windows machines with draconian
1412   AV software.
1413
1414   With this release, we remind everyone that 0.2.0.x has reached its
1415   formal end-of-life. Those Tor versions have many known flaws, and
1416   nobody should be using them. You should upgrade -- ideally to the
1417   0.2.2.x series. If you're using a Linux or BSD and its packages are
1418   obsolete, stop using those packages and upgrade anyway.
1419
1420   The Tor 0.2.1.x series is also approaching its end-of-life: it will no
1421   longer receive support after some time in early 2012.
1422
1423   o Major bugfixes:
1424     - Fix a heap overflow bug that could occur when trying to pull
1425       data into the first chunk of a buffer, when that chunk had
1426       already had some data drained from it. Fixes CVE-2011-2778;
1427       bugfix on 0.2.0.16-alpha. Reported by "Vektor".
1428     - Initialize Libevent with the EVENT_BASE_FLAG_NOLOCK flag enabled, so
1429       that it doesn't attempt to allocate a socketpair. This could cause
1430       some problems on Windows systems with overzealous firewalls. Fix for
1431       bug 4457; workaround for Libevent versions 2.0.1-alpha through
1432       2.0.15-stable.
1433     - If we mark an OR connection for close based on a cell we process,
1434       don't process any further cells on it. We already avoid further
1435       reads on marked-for-close connections, but now we also discard the
1436       cells we'd already read. Fixes bug 4299; bugfix on 0.2.0.10-alpha,
1437       which was the first version where we might mark a connection for
1438       close based on processing a cell on it.
1439     - Correctly sanity-check that we don't underflow on a memory
1440       allocation (and then assert) for hidden service introduction
1441       point decryption. Bug discovered by Dan Rosenberg. Fixes bug 4410;
1442       bugfix on 0.2.1.5-alpha.
1443     - Fix a memory leak when we check whether a hidden service
1444       descriptor has any usable introduction points left. Fixes bug
1445       4424. Bugfix on 0.2.2.25-alpha.
1446     - Don't crash when we're running as a relay and don't have a GeoIP
1447       file. Bugfix on 0.2.2.34; fixes bug 4340. This backports a fix
1448       we've had in the 0.2.3.x branch already.
1449     - When running as a client, do not print a misleading (and plain
1450       wrong) log message that we're collecting "directory request"
1451       statistics: clients don't collect statistics. Also don't create a
1452       useless (because empty) stats file in the stats/ directory. Fixes
1453       bug 4353; bugfix on 0.2.2.34.
1454
1455   o Minor bugfixes:
1456     - Detect failure to initialize Libevent. This fix provides better
1457       detection for future instances of bug 4457.
1458     - Avoid frequent calls to the fairly expensive cull_wedged_cpuworkers
1459       function. This was eating up hideously large amounts of time on some
1460       busy servers. Fixes bug 4518; bugfix on 0.0.9.8.
1461     - Resolve an integer overflow bug in smartlist_ensure_capacity().
1462       Fixes bug 4230; bugfix on Tor 0.1.0.1-rc. Based on a patch by
1463       Mansour Moufid.
1464     - Don't warn about unused log_mutex in log.c when building with
1465       --disable-threads using a recent GCC. Fixes bug 4437; bugfix on
1466       0.1.0.6-rc which introduced --disable-threads.
1467     - When configuring, starting, or stopping an NT service, stop
1468       immediately after the service configuration attempt has succeeded
1469       or failed. Fixes bug 3963; bugfix on 0.2.0.7-alpha.
1470     - When sending a NETINFO cell, include the original address
1471       received for the other side, not its canonical address. Found
1472       by "troll_un"; fixes bug 4349; bugfix on 0.2.0.10-alpha.
1473     - Fix a typo in a hibernation-related log message. Fixes bug 4331;
1474       bugfix on 0.2.2.23-alpha; found by "tmpname0901".
1475     - Fix a memory leak in launch_direct_bridge_descriptor_fetch() that
1476       occurred when a client tried to fetch a descriptor for a bridge
1477       in ExcludeNodes. Fixes bug 4383; bugfix on 0.2.2.25-alpha.
1478     - Backport fixes for a pair of compilation warnings on Windows.
1479       Fixes bug 4521; bugfix on 0.2.2.28-beta and on 0.2.2.29-beta.
1480     - If we had ever tried to call tor_addr_to_str on an address of
1481       unknown type, we would have done a strdup on an uninitialized
1482       buffer. Now we won't. Fixes bug 4529; bugfix on 0.2.1.3-alpha.
1483       Reported by "troll_un".
1484     - Correctly detect and handle transient lookup failures from
1485       tor_addr_lookup. Fixes bug 4530; bugfix on 0.2.1.5-alpha.
1486       Reported by "troll_un".
1487     - Fix null-pointer access that could occur if TLS allocation failed.
1488       Fixes bug 4531; bugfix on 0.2.0.20-rc. Found by "troll_un".
1489     - Use tor_socket_t type for listener argument to accept(). Fixes bug
1490       4535; bugfix on 0.2.2.28-beta. Found by "troll_un".
1491
1492   o Minor features:
1493     - Add two new config options for directory authorities:
1494       AuthDirFastGuarantee sets a bandwidth threshold for guaranteeing the
1495       Fast flag, and AuthDirGuardBWGuarantee sets a bandwidth threshold
1496       that is always sufficient to satisfy the bandwidth requirement for
1497       the Guard flag. Now it will be easier for researchers to simulate
1498       Tor networks with different values. Resolves ticket 4484.
1499     - When Tor ignores a hidden service specified in its configuration,
1500       include the hidden service's directory in the warning message.
1501       Previously, we would only tell the user that some hidden service
1502       was ignored. Bugfix on 0.0.6; fixes bug 4426.
1503     - Update to the December 6 2011 Maxmind GeoLite Country database.
1504
1505   o Packaging changes:
1506     - Make it easier to automate expert package builds on Windows,
1507       by removing an absolute path from makensis.exe command.
1508
1509
1510 Changes in version 0.2.3.9-alpha - 2011-12-08
1511   Tor 0.2.3.9-alpha introduces initial IPv6 support for bridges, adds
1512   a "DisableNetwork" security feature that bundles can use to avoid
1513   touching the network until bridges are configured, moves forward on
1514   the pluggable transport design, fixes a flaw in the hidden service
1515   design that unnecessarily prevented clients with wrong clocks from
1516   reaching hidden services, and fixes a wide variety of other issues.
1517
1518   o Major features:
1519     - Clients can now connect to private bridges over IPv6. Bridges
1520       still need at least one IPv4 address in order to connect to
1521       other relays. Note that we don't yet handle the case where the
1522       user has two bridge lines for the same bridge (one IPv4, one
1523       IPv6). Implements parts of proposal 186.
1524     - New "DisableNetwork" config option to prevent Tor from launching any
1525       connections or accepting any connections except on a control port.
1526       Bundles and controllers can set this option before letting Tor talk
1527       to the rest of the network, for example to prevent any connections
1528       to a non-bridge address. Packages like Orbot can also use this
1529       option to instruct Tor to save power when the network is off.
1530     - Clients and bridges can now be configured to use a separate
1531       "transport" proxy. This approach makes the censorship arms race
1532       easier by allowing bridges to use protocol obfuscation plugins. It
1533       implements the "managed proxy" part of proposal 180 (ticket 3472).
1534     - When using OpenSSL 1.0.0 or later, use OpenSSL's counter mode
1535       implementation. It makes AES_CTR about 7% faster than our old one
1536       (which was about 10% faster than the one OpenSSL used to provide).
1537       Resolves ticket 4526.
1538     - Add a "tor2web mode" for clients that want to connect to hidden
1539       services non-anonymously (and possibly more quickly). As a safety
1540       measure to try to keep users from turning this on without knowing
1541       what they are doing, tor2web mode must be explicitly enabled at
1542       compile time, and a copy of Tor compiled to run in tor2web mode
1543       cannot be used as a normal Tor client. Implements feature 2553.
1544     - Add experimental support for running on Windows with IOCP and no
1545       kernel-space socket buffers. This feature is controlled by a new
1546       "UserspaceIOCPBuffers" config option (off by default), which has
1547       no effect unless Tor has been built with support for bufferevents,
1548       is running on Windows, and has enabled IOCP. This may, in the long
1549       run, help solve or mitigate bug 98.
1550     - Use a more secure consensus parameter voting algorithm. Now at
1551       least three directory authorities or a majority of them must
1552       vote on a given parameter before it will be included in the
1553       consensus. Implements proposal 178.
1554
1555   o Major bugfixes:
1556     - Hidden services now ignore the timestamps on INTRODUCE2 cells.
1557       They used to check that the timestamp was within 30 minutes
1558       of their system clock, so they could cap the size of their
1559       replay-detection cache, but that approach unnecessarily refused
1560       service to clients with wrong clocks. Bugfix on 0.2.1.6-alpha, when
1561       the v3 intro-point protocol (the first one which sent a timestamp
1562       field in the INTRODUCE2 cell) was introduced; fixes bug 3460.
1563     - Only use the EVP interface when AES acceleration is enabled,
1564       to avoid a 5-7% performance regression. Resolves issue 4525;
1565       bugfix on 0.2.3.8-alpha.
1566
1567   o Privacy/anonymity features (bridge detection):
1568     - Make bridge SSL certificates a bit more stealthy by using random
1569       serial numbers, in the same fashion as OpenSSL when generating
1570       self-signed certificates. Implements ticket 4584.
1571     - Introduce a new config option "DynamicDHGroups", enabled by
1572       default, which provides each bridge with a unique prime DH modulus
1573       to be used during SSL handshakes. This option attempts to help
1574       against censors who might use the Apache DH modulus as a static
1575       identifier for bridges. Addresses ticket 4548.
1576
1577   o Minor features (new/different config options):
1578     - New configuration option "DisableDebuggerAttachment" (on by default)
1579       to prevent basic debugging attachment attempts by other processes.
1580       Supports Mac OS X and Gnu/Linux. Resolves ticket 3313.
1581     - Allow MapAddress directives to specify matches against super-domains,
1582       as in "MapAddress *.torproject.org *.torproject.org.torserver.exit".
1583       Implements issue 933.
1584     - Slightly change behavior of "list" options (that is, config
1585       options that can appear more than once) when they appear both in
1586       torrc and on the command line. Previously, the command-line options
1587       would be appended to the ones from torrc. Now, the command-line
1588       options override the torrc options entirely. This new behavior
1589       allows the user to override list options (like exit policies and
1590       ports to listen on) from the command line, rather than simply
1591       appending to the list.
1592     - You can get the old (appending) command-line behavior for "list"
1593       options by prefixing the option name with a "+".
1594     - You can remove all the values for a "list" option from the command
1595       line without adding any new ones by prefixing the option name
1596       with a "/".
1597     - Add experimental support for a "defaults" torrc file to be parsed
1598       before the regular torrc. Torrc options override the defaults file's
1599       options in the same way that the command line overrides the torrc.
1600       The SAVECONF controller command saves only those options which
1601       differ between the current configuration and the defaults file. HUP
1602       reloads both files. (Note: This is an experimental feature; its
1603       behavior will probably be refined in future 0.2.3.x-alpha versions
1604       to better meet packagers' needs.) Implements task 4552.
1605
1606   o Minor features:
1607     - Try to make the introductory warning message that Tor prints on
1608       startup more useful for actually finding help and information.
1609       Resolves ticket 2474.
1610     - Running "make version" now displays the version of Tor that
1611       we're about to build. Idea from katmagic; resolves issue 4400.
1612     - Expire old or over-used hidden service introduction points.
1613       Required by fix for bug 3460.
1614     - Move the replay-detection cache for the RSA-encrypted parts of
1615       INTRODUCE2 cells to the introduction point data structures.
1616       Previously, we would use one replay-detection cache per hidden
1617       service. Required by fix for bug 3460.
1618     - Reduce the lifetime of elements of hidden services' Diffie-Hellman
1619       public key replay-detection cache from 60 minutes to 5 minutes. This
1620       replay-detection cache is now used only to detect multiple
1621       INTRODUCE2 cells specifying the same rendezvous point, so we can
1622       avoid launching multiple simultaneous attempts to connect to it.
1623
1624   o Minor bugfixes (on Tor 0.2.2.x and earlier):
1625     - Resolve an integer overflow bug in smartlist_ensure_capacity().
1626       Fixes bug 4230; bugfix on Tor 0.1.0.1-rc. Based on a patch by
1627       Mansour Moufid.
1628     - Fix a minor formatting issue in one of tor-gencert's error messages.
1629       Fixes bug 4574.
1630     - Prevent a false positive from the check-spaces script, by disabling
1631       the "whitespace between function name and (" check for functions
1632       named 'op()'.
1633     - Fix a log message suggesting that people contact a non-existent
1634       email address. Fixes bug 3448.
1635     - Fix null-pointer access that could occur if TLS allocation failed.
1636       Fixes bug 4531; bugfix on 0.2.0.20-rc. Found by "troll_un".
1637     - Report a real bootstrap problem to the controller on router
1638       identity mismatch. Previously we just said "foo", which probably
1639       made a lot of sense at the time. Fixes bug 4169; bugfix on
1640       0.2.1.1-alpha.
1641     - If we had ever tried to call tor_addr_to_str() on an address of
1642       unknown type, we would have done a strdup() on an uninitialized
1643       buffer. Now we won't. Fixes bug 4529; bugfix on 0.2.1.3-alpha.
1644       Reported by "troll_un".
1645     - Correctly detect and handle transient lookup failures from
1646       tor_addr_lookup(). Fixes bug 4530; bugfix on 0.2.1.5-alpha.
1647       Reported by "troll_un".
1648     - Use tor_socket_t type for listener argument to accept(). Fixes bug
1649       4535; bugfix on 0.2.2.28-beta. Found by "troll_un".
1650     - Initialize conn->addr to a valid state in spawn_cpuworker(). Fixes
1651       bug 4532; found by "troll_un".
1652
1653   o Minor bugfixes (on Tor 0.2.3.x):
1654     - Fix a compile warning in tor_inet_pton(). Bugfix on 0.2.3.8-alpha;
1655       fixes bug 4554.
1656     - Don't send two ESTABLISH_RENDEZVOUS cells when opening a new
1657       circuit for use as a hidden service client's rendezvous point.
1658       Fixes bugs 4641 and 4171; bugfix on 0.2.3.3-alpha. Diagnosed
1659       with help from wanoskarnet.
1660     - Restore behavior of overriding SocksPort, ORPort, and similar
1661       options from the command line. Bugfix on 0.2.3.3-alpha.
1662
1663   o Build fixes:
1664     - Properly handle the case where the build-tree is not the same
1665       as the source tree when generating src/common/common_sha1.i,
1666       src/or/micro-revision.i, and src/or/or_sha1.i. Fixes bug 3953;
1667       bugfix on 0.2.0.1-alpha.
1668
1669   o Code simplifications, cleanups, and refactorings:
1670     - Remove the pure attribute from all functions that used it
1671       previously. In many cases we assigned it incorrectly, because the
1672       functions might assert or call impure functions, and we don't have
1673       evidence that keeping the pure attribute is worthwhile. Implements
1674       changes suggested in ticket 4421.
1675     - Remove some dead code spotted by coverity. Fixes cid 432.
1676       Bugfix on 0.2.3.1-alpha, closes bug 4637.
1677
1678
1679 Changes in version 0.2.3.8-alpha - 2011-11-22
1680   Tor 0.2.3.8-alpha fixes some crash and assert bugs, including a
1681   socketpair-related bug that has been bothering Windows users. It adds
1682   support to serve microdescriptors to controllers, so Vidalia's network
1683   map can resume listing relays (once Vidalia implements its side),
1684   and adds better support for hardware AES acceleration. Finally, it
1685   starts the process of adjusting the bandwidth cutoff for getting the
1686   "Fast" flag from 20KB to (currently) 32KB -- preliminary results show
1687   that tiny relays harm performance more than they help network capacity.
1688
1689   o Major bugfixes:
1690     - Initialize Libevent with the EVENT_BASE_FLAG_NOLOCK flag enabled, so
1691       that it doesn't attempt to allocate a socketpair. This could cause
1692       some problems on Windows systems with overzealous firewalls. Fix for
1693       bug 4457; workaround for Libevent versions 2.0.1-alpha through
1694       2.0.15-stable.
1695     - Correctly sanity-check that we don't underflow on a memory
1696       allocation (and then assert) for hidden service introduction
1697       point decryption. Bug discovered by Dan Rosenberg. Fixes bug 4410;
1698       bugfix on 0.2.1.5-alpha.
1699     - Remove the artificially low cutoff of 20KB to guarantee the Fast
1700       flag. In the past few years the average relay speed has picked
1701       up, and while the "top 7/8 of the network get the Fast flag" and
1702       "all relays with 20KB or more of capacity get the Fast flag" rules
1703       used to have the same result, now the top 7/8 of the network has
1704       a capacity more like 32KB. Bugfix on 0.2.1.14-rc. Fixes bug 4489.
1705     - Fix a rare assertion failure when checking whether a v0 hidden
1706       service descriptor has any usable introduction points left, and
1707       we don't have enough information to build a circuit to the first
1708       intro point named in the descriptor. The HS client code in
1709       0.2.3.x no longer uses v0 HS descriptors, but this assertion can
1710       trigger on (and crash) v0 HS authorities. Fixes bug 4411.
1711       Bugfix on 0.2.3.1-alpha; diagnosed by frosty_un.
1712     - Make bridge authorities not crash when they are asked for their own
1713       descriptor. Bugfix on 0.2.3.7-alpha, reported by Lucky Green.
1714     - When running as a client, do not print a misleading (and plain
1715       wrong) log message that we're collecting "directory request"
1716       statistics: clients don't collect statistics. Also don't create a
1717       useless (because empty) stats file in the stats/ directory. Fixes
1718       bug 4353; bugfix on 0.2.2.34 and 0.2.3.7-alpha.
1719
1720   o Major features:
1721     - Allow Tor controllers like Vidalia to obtain the microdescriptor
1722       for a relay by identity digest or nickname. Previously,
1723       microdescriptors were only available by their own digests, so a
1724       controller would have to ask for and parse the whole microdescriptor
1725       consensus in order to look up a single relay's microdesc. Fixes
1726       bug 3832; bugfix on 0.2.3.1-alpha.
1727     - Use OpenSSL's EVP interface for AES encryption, so that all AES
1728       operations can use hardware acceleration (if present). Resolves
1729       ticket 4442.
1730
1731   o Minor bugfixes (on 0.2.2.x and earlier):
1732     - Detect failure to initialize Libevent. This fix provides better
1733       detection for future instances of bug 4457.
1734     - Avoid frequent calls to the fairly expensive cull_wedged_cpuworkers
1735       function. This was eating up hideously large amounts of time on some
1736       busy servers. Fixes bug 4518; bugfix on 0.0.9.8.
1737     - Don't warn about unused log_mutex in log.c when building with
1738       --disable-threads using a recent GCC. Fixes bug 4437; bugfix on
1739       0.1.0.6-rc which introduced --disable-threads.
1740     - Allow manual 'authenticate' commands to the controller interface
1741       from netcat (nc) as well as telnet. We were rejecting them because
1742       they didn't come with the expected whitespace at the end of the
1743       command. Bugfix on 0.1.1.1-alpha; fixes bug 2893.
1744     - Fix some (not actually triggerable) buffer size checks in usage of
1745       tor_inet_ntop. Fixes bug 4434; bugfix on Tor 0.2.0.1-alpha. Patch
1746       by Anders Sundman.
1747     - Fix parsing of some corner-cases with tor_inet_pton(). Fixes
1748       bug 4515; bugfix on 0.2.0.1-alpha; fix by Anders Sundman.
1749     - When configuring, starting, or stopping an NT service, stop
1750       immediately after the service configuration attempt has succeeded
1751       or failed. Fixes bug 3963; bugfix on 0.2.0.7-alpha.
1752     - When sending a NETINFO cell, include the original address
1753       received for the other side, not its canonical address. Found
1754       by "troll_un"; fixes bug 4349; bugfix on 0.2.0.10-alpha.
1755     - Rename the bench_{aes,dmap} functions to test_*, so that tinytest
1756       can pick them up when the tests aren't disabled. Bugfix on
1757       0.2.2.4-alpha which introduced tinytest.
1758     - Fix a memory leak when we check whether a hidden service
1759       descriptor has any usable introduction points left. Fixes bug
1760       4424. Bugfix on 0.2.2.25-alpha.
1761     - Fix a memory leak in launch_direct_bridge_descriptor_fetch() that
1762       occurred when a client tried to fetch a descriptor for a bridge
1763       in ExcludeNodes. Fixes bug 4383; bugfix on 0.2.2.25-alpha.
1764
1765   o Minor bugfixes (on 0.2.3.x):
1766     - Make util unit tests build correctly with MSVC. Bugfix on
1767       0.2.3.3-alpha. Patch by Gisle Vanem.
1768     - Successfully detect AUTH_CHALLENGE cells with no recognized
1769       authentication type listed. Fixes bug 4367; bugfix on 0.2.3.6-alpha.
1770       Found by frosty_un.
1771     - If a relay receives an AUTH_CHALLENGE cell it can't answer,
1772       it should still send a NETINFO cell to allow the connection to
1773       become open. Fixes bug 4368; fix on 0.2.3.6-alpha; bug found by
1774       "frosty".
1775     - Log less loudly when we get an invalid authentication certificate
1776       from a source other than a directory authority: it's not unusual
1777       to see invalid certs because of clock skew. Fixes bug 4370; bugfix
1778       on 0.2.3.6-alpha.
1779     - Tolerate servers with more clock skew in their authentication
1780       certificates than previously. Fixes bug 4371; bugfix on
1781       0.2.3.6-alpha.
1782     - Fix a couple of compile warnings on Windows. Fixes bug 4469; bugfix
1783       on 0.2.3.4-alpha and 0.2.3.6-alpha.
1784
1785   o Minor features:
1786     - Add two new config options for directory authorities:
1787       AuthDirFastGuarantee sets a bandwidth threshold for guaranteeing the
1788       Fast flag, and AuthDirGuardBWGuarantee sets a bandwidth threshold
1789       that is always sufficient to satisfy the bandwidth requirement for
1790       the Guard flag. Now it will be easier for researchers to simulate
1791       Tor networks with different values. Resolves ticket 4484.
1792     - When Tor ignores a hidden service specified in its configuration,
1793       include the hidden service's directory in the warning message.
1794       Previously, we would only tell the user that some hidden service
1795       was ignored. Bugfix on 0.0.6; fixes bug 4426.
1796     - When we fail to initialize Libevent, retry with IOCP disabled so we
1797       don't need to turn on multi-threading support in Libevent, which in
1798       turn requires a working socketpair(). This is a workaround for bug
1799       4457, which affects Libevent versions from 2.0.1-alpha through
1800       2.0.15-stable.
1801     - Detect when we try to build on a platform that doesn't define
1802       AF_UNSPEC to 0. We don't work there, so refuse to compile.
1803     - Update to the November 1 2011 Maxmind GeoLite Country database.
1804
1805   o Packaging changes:
1806     - Make it easier to automate expert package builds on Windows,
1807       by removing an absolute path from makensis.exe command.
1808
1809   o Code simplifications and refactoring:
1810     - Remove some redundant #include directives throughout the code.
1811       Patch from Andrea Gelmini.
1812     - Unconditionally use OpenSSL's AES implementation instead of our
1813       old built-in one. OpenSSL's AES has been better for a while, and
1814       relatively few servers should still be on any version of OpenSSL
1815       that doesn't have good optimized assembly AES.
1816     - Use the name "CERTS" consistently to refer to the new cell type;
1817       we were calling it CERT in some places and CERTS in others.
1818
1819   o Testing:
1820     - Numerous new unit tests for functions in util.c and address.c by
1821       Anders Sundman.
1822     - The long-disabled benchmark tests are now split into their own
1823       ./src/test/bench binary.
1824     - The benchmark tests can now use more accurate timers than
1825       gettimeofday() when such timers are available.
1826
1827
1828 Changes in version 0.2.3.7-alpha - 2011-10-30
1829   Tor 0.2.3.7-alpha fixes a crash bug in 0.2.3.6-alpha introduced by
1830   the new v3 handshake. It also resolves yet another bridge address
1831   enumeration issue.
1832
1833   o Major bugfixes:
1834     - If we mark an OR connection for close based on a cell we process,
1835       don't process any further cells on it. We already avoid further
1836       reads on marked-for-close connections, but now we also discard the
1837       cells we'd already read. Fixes bug 4299; bugfix on 0.2.0.10-alpha,
1838       which was the first version where we might mark a connection for
1839       close based on processing a cell on it.
1840     - Fix a double-free bug that would occur when we received an invalid
1841       certificate in a CERT cell in the new v3 handshake. Fixes bug 4343;
1842       bugfix on 0.2.3.6-alpha.
1843     - Bridges no longer include their address in NETINFO cells on outgoing
1844       OR connections, to allow them to blend in better with clients.
1845       Removes another avenue for enumerating bridges. Reported by
1846       "troll_un". Fixes bug 4348; bugfix on 0.2.0.10-alpha, when NETINFO
1847       cells were introduced.
1848
1849   o Trivial fixes:
1850     - Fixed a typo in a hibernation-related log message. Fixes bug 4331;
1851       bugfix on 0.2.2.23-alpha; found by "tmpname0901".
1852
1853
1854 Changes in version 0.2.3.6-alpha - 2011-10-26
1855   Tor 0.2.3.6-alpha includes the fix from 0.2.2.34 for a critical
1856   anonymity vulnerability where an attacker can deanonymize Tor
1857   users. Everybody should upgrade.
1858
1859   This release also features support for a new v3 connection handshake
1860   protocol, and fixes to make hidden service connections more robust.
1861
1862   o Major features:
1863     - Implement a new handshake protocol (v3) for authenticating Tors to
1864       each other over TLS. It should be more resistant to fingerprinting
1865       than previous protocols, and should require less TLS hacking for
1866       future Tor implementations. Implements proposal 176.
1867     - Allow variable-length padding cells to disguise the length of
1868       Tor's TLS records. Implements part of proposal 184.
1869
1870   o Privacy/anonymity fixes (clients):
1871     - Clients and bridges no longer send TLS certificate chains on
1872       outgoing OR connections. Previously, each client or bridge would
1873       use the same cert chain for all outgoing OR connections until
1874       its IP address changes, which allowed any relay that the client
1875       or bridge contacted to determine which entry guards it is using.
1876       Fixes CVE-2011-2768. Bugfix on 0.0.9pre5; found by "frosty_un".
1877     - If a relay receives a CREATE_FAST cell on a TLS connection, it
1878       no longer considers that connection as suitable for satisfying a
1879       circuit EXTEND request. Now relays can protect clients from the
1880       CVE-2011-2768 issue even if the clients haven't upgraded yet.
1881     - Directory authorities no longer assign the Guard flag to relays
1882       that haven't upgraded to the above "refuse EXTEND requests
1883       to client connections" fix. Now directory authorities can
1884       protect clients from the CVE-2011-2768 issue even if neither
1885       the clients nor the relays have upgraded yet. There's a new
1886       "GiveGuardFlagTo_CVE_2011_2768_VulnerableRelays" config option
1887       to let us transition smoothly, else tomorrow there would be no
1888       guard relays.
1889
1890   o Major bugfixes (hidden services):
1891     - Improve hidden service robustness: when an attempt to connect to
1892       a hidden service ends, be willing to refetch its hidden service
1893       descriptors from each of the HSDir relays responsible for them
1894       immediately. Previously, we would not consider refetching the
1895       service's descriptors from each HSDir for 15 minutes after the last
1896       fetch, which was inconvenient if the hidden service was not running
1897       during the first attempt. Bugfix on 0.2.0.18-alpha; fixes bug 3335.
1898     - When one of a hidden service's introduction points appears to be
1899       unreachable, stop trying it. Previously, we would keep trying
1900       to build circuits to the introduction point until we lost the
1901       descriptor, usually because the user gave up and restarted Tor.
1902       Partly fixes bug 3825.
1903     - Don't launch a useless circuit after failing to use one of a
1904       hidden service's introduction points. Previously, we would
1905       launch a new introduction circuit, but not set the hidden service
1906       which that circuit was intended to connect to, so it would never
1907       actually be used. A different piece of code would then create a
1908       new introduction circuit correctly. Bug reported by katmagic and
1909       found by Sebastian Hahn. Bugfix on 0.2.1.13-alpha; fixes bug 4212.
1910
1911   o Major bugfixes (other):
1912     - Bridges now refuse CREATE or CREATE_FAST cells on OR connections
1913       that they initiated. Relays could distinguish incoming bridge
1914       connections from client connections, creating another avenue for
1915       enumerating bridges. Fixes CVE-2011-2769. Bugfix on 0.2.0.3-alpha.
1916       Found by "frosty_un".
1917     - Don't update the AccountingSoftLimitHitAt state file entry whenever
1918       tor gets started. This prevents a wrong average bandwidth
1919       estimate, which would cause relays to always start a new accounting
1920       interval at the earliest possible moment. Fixes bug 2003; bugfix
1921       on 0.2.2.7-alpha. Reported by BryonEldridge, who also helped
1922       immensely in tracking this bug down.
1923     - Fix a crash bug when changing node restrictions while a DNS lookup
1924       is in-progress. Fixes bug 4259; bugfix on 0.2.2.25-alpha. Bugfix
1925       by "Tey'".
1926
1927   o Minor bugfixes (on 0.2.2.x and earlier):
1928     - When a hidden service turns an extra service-side introduction
1929       circuit into a general-purpose circuit, free the rend_data and
1930       intro_key fields first, so we won't leak memory if the circuit
1931       is cannibalized for use as another service-side introduction
1932       circuit. Bugfix on 0.2.1.7-alpha; fixes bug 4251.
1933     - Rephrase the log message emitted if the TestSocks check is
1934       successful. Patch from Fabian Keil; fixes bug 4094.
1935     - Bridges now skip DNS self-tests, to act a little more stealthily.
1936       Fixes bug 4201; bugfix on 0.2.0.3-alpha, which first introduced
1937       bridges. Patch by "warms0x".
1938     - Remove a confusing dollar sign from the example fingerprint in the
1939       man page, and also make the example fingerprint a valid one. Fixes
1940       bug 4309; bugfix on 0.2.1.3-alpha.
1941     - Fix internal bug-checking logic that was supposed to catch
1942       failures in digest generation so that it will fail more robustly
1943       if we ask for a nonexistent algorithm. Found by Coverity Scan.
1944       Bugfix on 0.2.2.1-alpha; fixes Coverity CID 479.
1945     - Report any failure in init_keys() calls launched because our
1946       IP address has changed. Spotted by Coverity Scan. Bugfix on
1947       0.1.1.4-alpha; fixes CID 484.
1948
1949   o Minor bugfixes (on 0.2.3.x):
1950     - Fix a bug in configure.in that kept it from building a configure
1951       script with autoconf versions earlier than 2.61. Fixes bug 2430;
1952       bugfix on 0.2.3.1-alpha.
1953     - Don't warn users that they are exposing a client port to the
1954       Internet if they have specified an RFC1918 address. Previously,
1955       we would warn if the user had specified any non-loopback
1956       address. Bugfix on 0.2.3.3-alpha. Fixes bug 4018; reported by Tas.
1957     - Fix memory leaks in the failing cases of the new SocksPort and
1958       ControlPort code. Found by Coverity Scan. Bugfix on 0.2.3.3-alpha;
1959       fixes coverity CIDs 485, 486, and 487.
1960
1961   o Minor features:
1962     - When a hidden service's introduction point times out, consider
1963       trying it again during the next attempt to connect to the
1964       HS. Previously, we would not try it again unless a newly fetched
1965       descriptor contained it. Required by fixes for bugs 1297 and 3825.
1966     - The next version of Windows will be called Windows 8, and it has
1967       a major version of 6, minor version of 2. Correctly identify that
1968       version instead of calling it "Very recent version". Resolves
1969       ticket 4153; reported by funkstar.
1970     - The Bridge Authority now writes statistics on how many bridge
1971       descriptors it gave out in total, and how many unique descriptors
1972       it gave out. It also lists how often the most and least commonly
1973       fetched descriptors were given out, as well as the median and
1974       25th/75th percentile. Implements tickets 4200 and 4294.
1975     - Update to the October 4 2011 Maxmind GeoLite Country database.
1976
1977   o Code simplifications and refactoring:
1978     - Remove some old code to remember statistics about which descriptors
1979       we've served as a directory mirror. The feature wasn't used and
1980       is outdated now that microdescriptors are around.
1981     - Rename Tor functions that turn strings into addresses, so that
1982       "parse" indicates that no hostname resolution occurs, and
1983       "lookup" indicates that hostname resolution may occur. This
1984       should help prevent mistakes in the future. Fixes bug 3512.
1985
1986
1987 Changes in version 0.2.2.34 - 2011-10-26
1988   Tor 0.2.2.34 fixes a critical anonymity vulnerability where an attacker
1989   can deanonymize Tor users. Everybody should upgrade.
1990
1991   The attack relies on four components: 1) Clients reuse their TLS cert
1992   when talking to different relays, so relays can recognize a user by
1993   the identity key in her cert. 2) An attacker who knows the client's
1994   identity key can probe each guard relay to see if that identity key
1995   is connected to that guard relay right now. 3) A variety of active
1996   attacks in the literature (starting from "Low-Cost Traffic Analysis
1997   of Tor" by Murdoch and Danezis in 2005) allow a malicious website to
1998   discover the guard relays that a Tor user visiting the website is using.
1999   4) Clients typically pick three guards at random, so the set of guards
2000   for a given user could well be a unique fingerprint for her. This
2001   release fixes components #1 and #2, which is enough to block the attack;
2002   the other two remain as open research problems. Special thanks to
2003   "frosty_un" for reporting the issue to us!
2004
2005   Clients should upgrade so they are no longer recognizable by the TLS
2006   certs they present. Relays should upgrade so they no longer allow a
2007   remote attacker to probe them to test whether unpatched clients are
2008   currently connected to them.
2009
2010   This release also fixes several vulnerabilities that allow an attacker
2011   to enumerate bridge relays. Some bridge enumeration attacks still
2012   remain; see for example proposal 188.
2013
2014   o Privacy/anonymity fixes (clients):
2015     - Clients and bridges no longer send TLS certificate chains on
2016       outgoing OR connections. Previously, each client or bridge would
2017       use the same cert chain for all outgoing OR connections until
2018       its IP address changes, which allowed any relay that the client
2019       or bridge contacted to determine which entry guards it is using.
2020       Fixes CVE-2011-2768. Bugfix on 0.0.9pre5; found by "frosty_un".
2021     - If a relay receives a CREATE_FAST cell on a TLS connection, it
2022       no longer considers that connection as suitable for satisfying a
2023       circuit EXTEND request. Now relays can protect clients from the
2024       CVE-2011-2768 issue even if the clients haven't upgraded yet.
2025     - Directory authorities no longer assign the Guard flag to relays
2026       that haven't upgraded to the above "refuse EXTEND requests
2027       to client connections" fix. Now directory authorities can
2028       protect clients from the CVE-2011-2768 issue even if neither
2029       the clients nor the relays have upgraded yet. There's a new
2030       "GiveGuardFlagTo_CVE_2011_2768_VulnerableRelays" config option
2031       to let us transition smoothly, else tomorrow there would be no
2032       guard relays.
2033
2034   o Privacy/anonymity fixes (bridge enumeration):
2035     - Bridge relays now do their directory fetches inside Tor TLS
2036       connections, like all the other clients do, rather than connecting
2037       directly to the DirPort like public relays do. Removes another
2038       avenue for enumerating bridges. Fixes bug 4115; bugfix on 0.2.0.35.
2039     - Bridges relays now build circuits for themselves in a more similar
2040       way to how clients build them. Removes another avenue for
2041       enumerating bridges. Fixes bug 4124; bugfix on 0.2.0.3-alpha,
2042       when bridges were introduced.
2043     - Bridges now refuse CREATE or CREATE_FAST cells on OR connections
2044       that they initiated. Relays could distinguish incoming bridge
2045       connections from client connections, creating another avenue for
2046       enumerating bridges. Fixes CVE-2011-2769. Bugfix on 0.2.0.3-alpha.
2047       Found by "frosty_un".
2048
2049   o Major bugfixes:
2050     - Fix a crash bug when changing node restrictions while a DNS lookup
2051       is in-progress. Fixes bug 4259; bugfix on 0.2.2.25-alpha. Bugfix
2052       by "Tey'".
2053     - Don't launch a useless circuit after failing to use one of a
2054       hidden service's introduction points. Previously, we would
2055       launch a new introduction circuit, but not set the hidden service
2056       which that circuit was intended to connect to, so it would never
2057       actually be used. A different piece of code would then create a
2058       new introduction circuit correctly. Bug reported by katmagic and
2059       found by Sebastian Hahn. Bugfix on 0.2.1.13-alpha; fixes bug 4212.
2060
2061   o Minor bugfixes:
2062     - Change an integer overflow check in the OpenBSD_Malloc code so
2063       that GCC is less likely to eliminate it as impossible. Patch
2064       from Mansour Moufid. Fixes bug 4059.
2065     - When a hidden service turns an extra service-side introduction
2066       circuit into a general-purpose circuit, free the rend_data and
2067       intro_key fields first, so we won't leak memory if the circuit
2068       is cannibalized for use as another service-side introduction
2069       circuit. Bugfix on 0.2.1.7-alpha; fixes bug 4251.
2070     - Bridges now skip DNS self-tests, to act a little more stealthily.
2071       Fixes bug 4201; bugfix on 0.2.0.3-alpha, which first introduced
2072       bridges. Patch by "warms0x".
2073     - Fix internal bug-checking logic that was supposed to catch
2074       failures in digest generation so that it will fail more robustly
2075       if we ask for a nonexistent algorithm. Found by Coverity Scan.
2076       Bugfix on 0.2.2.1-alpha; fixes Coverity CID 479.
2077     - Report any failure in init_keys() calls launched because our
2078       IP address has changed. Spotted by Coverity Scan. Bugfix on
2079       0.1.1.4-alpha; fixes CID 484.
2080
2081   o Minor bugfixes (log messages and documentation):
2082     - Remove a confusing dollar sign from the example fingerprint in the
2083       man page, and also make the example fingerprint a valid one. Fixes
2084       bug 4309; bugfix on 0.2.1.3-alpha.
2085     - The next version of Windows will be called Windows 8, and it has
2086       a major version of 6, minor version of 2. Correctly identify that
2087       version instead of calling it "Very recent version". Resolves
2088       ticket 4153; reported by funkstar.
2089     - Downgrade log messages about circuit timeout calibration from
2090       "notice" to "info": they don't require or suggest any human
2091       intervention. Patch from Tom Lowenthal. Fixes bug 4063;
2092       bugfix on 0.2.2.14-alpha.
2093
2094   o Minor features:
2095     - Turn on directory request statistics by default and include them in
2096       extra-info descriptors. Don't break if we have no GeoIP database.
2097       Backported from 0.2.3.1-alpha; implements ticket 3951.
2098     - Update to the October 4 2011 Maxmind GeoLite Country database.
2099
2100
2101 Changes in version 0.2.1.31 - 2011-10-26
2102   Tor 0.2.1.31 backports important security and privacy fixes for
2103   oldstable. This release is intended only for package maintainers and
2104   others who cannot use the 0.2.2 stable series. All others should be
2105   using Tor 0.2.2.x or newer.
2106
2107   o Security fixes (also included in 0.2.2.x):
2108     - Replace all potentially sensitive memory comparison operations
2109       with versions whose runtime does not depend on the data being
2110       compared. This will help resist a class of attacks where an
2111       adversary can use variations in timing information to learn
2112       sensitive data. Fix for one case of bug 3122. (Safe memcmp
2113       implementation by Robert Ransom based partially on code by DJB.)
2114     - Fix an assert in parsing router descriptors containing IPv6
2115       addresses. This one took down the directory authorities when
2116       somebody tried some experimental code. Bugfix on 0.2.1.3-alpha.
2117
2118   o Privacy/anonymity fixes (also included in 0.2.2.x):
2119     - Clients and bridges no longer send TLS certificate chains on
2120       outgoing OR connections. Previously, each client or bridge would
2121       use the same cert chain for all outgoing OR connections until
2122       its IP address changes, which allowed any relay that the client
2123       or bridge contacted to determine which entry guards it is using.
2124       Fixes CVE-2011-2768. Bugfix on 0.0.9pre5; found by "frosty_un".
2125     - If a relay receives a CREATE_FAST cell on a TLS connection, it
2126       no longer considers that connection as suitable for satisfying a
2127       circuit EXTEND request. Now relays can protect clients from the
2128       CVE-2011-2768 issue even if the clients haven't upgraded yet.
2129     - Bridges now refuse CREATE or CREATE_FAST cells on OR connections
2130       that they initiated. Relays could distinguish incoming bridge
2131       connections from client connections, creating another avenue for
2132       enumerating bridges. Fixes CVE-2011-2769. Bugfix on 0.2.0.3-alpha.
2133       Found by "frosty_un".
2134     - When receiving a hidden service descriptor, check that it is for
2135       the hidden service we wanted. Previously, Tor would store any
2136       hidden service descriptors that a directory gave it, whether it
2137       wanted them or not. This wouldn't have let an attacker impersonate
2138       a hidden service, but it did let directories pre-seed a client
2139       with descriptors that it didn't want. Bugfix on 0.0.6.
2140     - Avoid linkability based on cached hidden service descriptors: forget
2141       all hidden service descriptors cached as a client when processing a
2142       SIGNAL NEWNYM command. Fixes bug 3000; bugfix on 0.0.6.
2143     - Make the bridge directory authority refuse to answer directory
2144       requests for "all" descriptors. It used to include bridge
2145       descriptors in its answer, which was a major information leak.
2146       Found by "piebeer". Bugfix on 0.2.0.3-alpha.
2147     - Don't attach new streams to old rendezvous circuits after SIGNAL
2148       NEWNYM. Previously, we would keep using an existing rendezvous
2149       circuit if it remained open (i.e. if it were kept open by a
2150       long-lived stream, or if a new stream were attached to it before
2151       Tor could notice that it was old and no longer in use). Bugfix on
2152       0.1.1.15-rc; fixes bug 3375.
2153
2154   o Minor bugfixes (also included in 0.2.2.x):
2155     - When we restart our relay, we might get a successful connection
2156       from the outside before we've started our reachability tests,
2157       triggering a warning: "ORPort found reachable, but I have no
2158       routerinfo yet. Failing to inform controller of success." This
2159       bug was harmless unless Tor is running under a controller
2160       like Vidalia, in which case the controller would never get a
2161       REACHABILITY_SUCCEEDED status event. Bugfix on 0.1.2.6-alpha;
2162       fixes bug 1172.
2163     - Build correctly on OSX with zlib 1.2.4 and higher with all warnings
2164       enabled. Fixes bug 1526.
2165     - Remove undocumented option "-F" from tor-resolve: it hasn't done
2166       anything since 0.2.1.16-rc.
2167     - Avoid signed/unsigned comparisons by making SIZE_T_CEILING unsigned.
2168       None of the cases where we did this before were wrong, but by making
2169       this change we avoid warnings. Fixes bug 2475; bugfix on 0.2.1.28.
2170     - Fix a rare crash bug that could occur when a client was configured
2171       with a large number of bridges. Fixes bug 2629; bugfix on
2172       0.2.1.2-alpha. Bugfix by trac user "shitlei".
2173     - Correct the warning displayed when a rendezvous descriptor exceeds
2174       the maximum size. Fixes bug 2750; bugfix on 0.2.1.5-alpha. Found by
2175       John Brooks.
2176     - Fix an uncommon assertion failure when running with DNSPort under
2177       heavy load. Fixes bug 2933; bugfix on 0.2.0.1-alpha.
2178     - When warning about missing zlib development packages during compile,
2179       give the correct package names. Bugfix on 0.2.0.1-alpha.
2180     - Require that introduction point keys and onion keys have public
2181       exponent 65537. Bugfix on 0.2.0.10-alpha.
2182     - Do not crash when our configuration file becomes unreadable, for
2183       example due to a permissions change, between when we start up
2184       and when a controller calls SAVECONF. Fixes bug 3135; bugfix
2185       on 0.0.9pre6.
2186     - Fix warnings from GCC 4.6's "-Wunused-but-set-variable" option.
2187       Fixes bug 3208.
2188     - Always NUL-terminate the sun_path field of a sockaddr_un before
2189       passing it to the kernel. (Not a security issue: kernels are
2190       smart enough to reject bad sockaddr_uns.) Found by Coverity;
2191       CID #428. Bugfix on Tor 0.2.0.3-alpha.
2192     - Don't stack-allocate the list of supplementary GIDs when we're
2193       about to log them. Stack-allocating NGROUPS_MAX gid_t elements
2194       could take up to 256K, which is way too much stack. Found by
2195       Coverity; CID #450. Bugfix on 0.2.1.7-alpha.
2196
2197   o Minor bugfixes (only in 0.2.1.x):
2198     - Resume using micro-version numbers in 0.2.1.x: our Debian packages
2199       rely on them. Bugfix on 0.2.1.30.
2200     - Use git revisions instead of svn revisions when generating our
2201       micro-version numbers. Bugfix on 0.2.1.15-rc; fixes bug 2402.
2202
2203   o Minor features (also included in 0.2.2.x):
2204     - Adjust the expiration time on our SSL session certificates to
2205       better match SSL certs seen in the wild. Resolves ticket 4014.
2206     - Allow nameservers with IPv6 address. Resolves bug 2574.
2207     - Update to the October 4 2011 Maxmind GeoLite Country database.
2208
2209
2210 Changes in version 0.2.3.5-alpha - 2011-09-28
2211   Tor 0.2.3.5-alpha fixes two bugs that make it possible to enumerate
2212   bridge relays; fixes an assertion error that many users started hitting
2213   today; and adds the ability to refill token buckets more often than
2214   once per second, allowing significant performance improvements.
2215
2216   o Security fixes:
2217     - Bridge relays now do their directory fetches inside Tor TLS
2218       connections, like all the other clients do, rather than connecting
2219       directly to the DirPort like public relays do. Removes another
2220       avenue for enumerating bridges. Fixes bug 4115; bugfix on 0.2.0.35.
2221     - Bridges relays now build circuits for themselves in a more similar
2222       way to how clients build them. Removes another avenue for
2223       enumerating bridges. Fixes bug 4124; bugfix on 0.2.0.3-alpha,
2224       when bridges were introduced.
2225
2226   o Major bugfixes:
2227     - Fix an "Assertion md->held_by_node == 1 failed" error that could
2228       occur when the same microdescriptor was referenced by two node_t
2229       objects at once. Fix for bug 4118; bugfix on Tor 0.2.3.1-alpha.
2230
2231   o Major features (networking):
2232     - Add a new TokenBucketRefillInterval option to refill token buckets
2233       more frequently than once per second. This should improve network
2234       performance, alleviate queueing problems, and make traffic less
2235       bursty. Implements proposal 183; closes ticket 3630. Design by
2236       Florian Tschorsch and Björn Scheuermann; implementation by
2237       Florian Tschorsch.
2238
2239   o Minor bugfixes:
2240     - Change an integer overflow check in the OpenBSD_Malloc code so
2241       that GCC is less likely to eliminate it as impossible. Patch
2242       from Mansour Moufid. Fixes bug 4059.
2243
2244   o Minor bugfixes (usability):
2245     - Downgrade log messages about circuit timeout calibration from
2246       "notice" to "info": they don't require or suggest any human
2247       intervention. Patch from Tom Lowenthal. Fixes bug 4063;
2248       bugfix on 0.2.2.14-alpha.
2249
2250   o Minor features (diagnostics):
2251     - When the system call to create a listener socket fails, log the
2252       error message explaining why. This may help diagnose bug 4027.
2253
2254
2255 Changes in version 0.2.3.4-alpha - 2011-09-13
2256   Tor 0.2.3.4-alpha includes the fixes from 0.2.2.33, including a slight
2257   tweak to Tor's TLS handshake that makes relays and bridges that run
2258   this new version reachable from Iran again. It also fixes a few new
2259   bugs in 0.2.3.x, and teaches relays to recognize when they're not
2260   listed in the network consensus and republish.
2261
2262   o Major bugfixes (also part of 0.2.2.33):
2263     - Avoid an assertion failure when reloading a configuration with
2264       TrackExitHosts changes. Found and fixed by 'laruldan'. Fixes bug
2265       3923; bugfix on 0.2.2.25-alpha.
2266
2267   o Minor features (security, also part of 0.2.2.33):
2268     - Check for replays of the public-key encrypted portion of an
2269       INTRODUCE1 cell, in addition to the current check for replays of
2270       the g^x value. This prevents a possible class of active attacks
2271       by an attacker who controls both an introduction point and a
2272       rendezvous point, and who uses the malleability of AES-CTR to
2273       alter the encrypted g^x portion of the INTRODUCE1 cell. We think
2274       that these attacks is infeasible (requiring the attacker to send
2275       on the order of zettabytes of altered cells in a short interval),
2276       but we'd rather block them off in case there are any classes of
2277       this attack that we missed. Reported by Willem Pinckaers.
2278
2279   o Minor features (also part of 0.2.2.33):
2280     - Adjust the expiration time on our SSL session certificates to
2281       better match SSL certs seen in the wild. Resolves ticket 4014.
2282     - Change the default required uptime for a relay to be accepted as
2283       a HSDir (hidden service directory) from 24 hours to 25 hours.
2284       Improves on 0.2.0.10-alpha; resolves ticket 2649.
2285     - Add a VoteOnHidServDirectoriesV2 config option to allow directory
2286       authorities to abstain from voting on assignment of the HSDir
2287       consensus flag. Related to bug 2649.
2288     - Update to the September 6 2011 Maxmind GeoLite Country database.
2289
2290   o Minor bugfixes (also part of 0.2.2.33):
2291     - Demote the 'replay detected' log message emitted when a hidden
2292       service receives the same Diffie-Hellman public key in two different
2293       INTRODUCE2 cells to info level. A normal Tor client can cause that
2294       log message during its normal operation. Bugfix on 0.2.1.6-alpha;
2295       fixes part of bug 2442.
2296     - Demote the 'INTRODUCE2 cell is too {old,new}' log message to info
2297       level. There is nothing that a hidden service's operator can do
2298       to fix its clients' clocks. Bugfix on 0.2.1.6-alpha; fixes part
2299       of bug 2442.
2300     - Clarify a log message specifying the characters permitted in
2301       HiddenServiceAuthorizeClient client names. Previously, the log
2302       message said that "[A-Za-z0-9+-_]" were permitted; that could have
2303       given the impression that every ASCII character between "+" and "_"
2304       was permitted. Now we say "[A-Za-z0-9+_-]". Bugfix on 0.2.1.5-alpha.
2305
2306   o Build fixes (also part of 0.2.2.33):
2307     - Clean up some code issues that prevented Tor from building on older
2308       BSDs. Fixes bug 3894; reported by "grarpamp".
2309     - Search for a platform-specific version of "ar" when cross-compiling.
2310       Should fix builds on iOS. Resolves bug 3909, found by Marco Bonetti.
2311
2312   o Major bugfixes:
2313     - Fix a bug where the SocksPort option (for example) would get
2314       ignored and replaced by the default if a SocksListenAddress
2315       option was set. Bugfix on 0.2.3.3-alpha; fixes bug 3936. Fix by
2316       Fabian Keil.
2317
2318   o Major features:
2319     - Relays now try regenerating and uploading their descriptor more
2320       frequently if they are not listed in the consensus, or if the
2321       version of their descriptor listed in the consensus is too
2322       old. This fix should prevent situations where a server declines
2323       to re-publish itself because it has done so too recently, even
2324       though the authorities decided not to list its recent-enough
2325       descriptor. Fix for bug 3327.
2326
2327   o Minor features:
2328     - Relays now include a reason for regenerating their descriptors
2329       in an HTTP header when uploading to the authorities. This will
2330       make it easier to debug descriptor-upload issues in the future.
2331     - When starting as root and then changing our UID via the User
2332       control option, and we have a ControlSocket configured, make sure
2333       that the ControlSocket is owned by the same account that Tor will
2334       run under. Implements ticket 3421; fix by Jérémy Bobbio.
2335
2336   o Minor bugfixes:
2337     - Abort if tor_vasprintf fails in connection_printf_to_buf (a
2338       utility function used in the control-port code). This shouldn't
2339       ever happen unless Tor is completely out of memory, but if it did
2340       happen and Tor somehow recovered from it, Tor could have sent a log
2341       message to a control port in the middle of a reply to a controller
2342       command. Fixes part of bug 3428; bugfix on 0.1.2.3-alpha.
2343     - Make 'FetchUselessDescriptors' cause all descriptor types and
2344       all consensus types (including microdescriptors) to get fetched.
2345       Fixes bug 3851; bugfix on 0.2.3.1-alpha.
2346
2347   o Code refactoring:
2348     - Make a new "entry connection" struct as an internal subtype of "edge
2349       connection", to simplify the code and make exit connections smaller.
2350
2351
2352 Changes in version 0.2.2.33 - 2011-09-13
2353   Tor 0.2.2.33 fixes several bugs, and includes a slight tweak to Tor's
2354   TLS handshake that makes relays and bridges that run this new version
2355   reachable from Iran again.
2356
2357   o Major bugfixes:
2358     - Avoid an assertion failure when reloading a configuration with
2359       TrackExitHosts changes. Found and fixed by 'laruldan'. Fixes bug
2360       3923; bugfix on 0.2.2.25-alpha.
2361
2362   o Minor features (security):
2363     - Check for replays of the public-key encrypted portion of an
2364       INTRODUCE1 cell, in addition to the current check for replays of
2365       the g^x value. This prevents a possible class of active attacks
2366       by an attacker who controls both an introduction point and a
2367       rendezvous point, and who uses the malleability of AES-CTR to
2368       alter the encrypted g^x portion of the INTRODUCE1 cell. We think
2369       that these attacks are infeasible (requiring the attacker to send
2370       on the order of zettabytes of altered cells in a short interval),
2371       but we'd rather block them off in case there are any classes of
2372       this attack that we missed. Reported by Willem Pinckaers.
2373
2374   o Minor features:
2375     - Adjust the expiration time on our SSL session certificates to
2376       better match SSL certs seen in the wild. Resolves ticket 4014.
2377     - Change the default required uptime for a relay to be accepted as
2378       a HSDir (hidden service directory) from 24 hours to 25 hours.
2379       Improves on 0.2.0.10-alpha; resolves ticket 2649.
2380     - Add a VoteOnHidServDirectoriesV2 config option to allow directory
2381       authorities to abstain from voting on assignment of the HSDir
2382       consensus flag. Related to bug 2649.
2383     - Update to the September 6 2011 Maxmind GeoLite Country database.
2384
2385   o Minor bugfixes (documentation and log messages):
2386     - Correct the man page to explain that HashedControlPassword and
2387       CookieAuthentication can both be set, in which case either method
2388       is sufficient to authenticate to Tor. Bugfix on 0.2.0.7-alpha,
2389       when we decided to allow these config options to both be set. Issue
2390       raised by bug 3898.
2391     - Demote the 'replay detected' log message emitted when a hidden
2392       service receives the same Diffie-Hellman public key in two different
2393       INTRODUCE2 cells to info level. A normal Tor client can cause that
2394       log message during its normal operation. Bugfix on 0.2.1.6-alpha;
2395       fixes part of bug 2442.
2396     - Demote the 'INTRODUCE2 cell is too {old,new}' log message to info
2397       level. There is nothing that a hidden service's operator can do
2398       to fix its clients' clocks. Bugfix on 0.2.1.6-alpha; fixes part
2399       of bug 2442.
2400     - Clarify a log message specifying the characters permitted in
2401       HiddenServiceAuthorizeClient client names. Previously, the log
2402       message said that "[A-Za-z0-9+-_]" were permitted; that could have
2403       given the impression that every ASCII character between "+" and "_"
2404       was permitted. Now we say "[A-Za-z0-9+_-]". Bugfix on 0.2.1.5-alpha.
2405
2406   o Build fixes:
2407     - Provide a substitute implementation of lround() for MSVC, which
2408       apparently lacks it. Patch from Gisle Vanem.
2409     - Clean up some code issues that prevented Tor from building on older
2410       BSDs. Fixes bug 3894; reported by "grarpamp".
2411     - Search for a platform-specific version of "ar" when cross-compiling.
2412       Should fix builds on iOS. Resolves bug 3909, found by Marco Bonetti.
2413
2414
2415 Changes in version 0.2.3.3-alpha - 2011-09-01
2416   Tor 0.2.3.3-alpha adds a new "stream isolation" feature to improve Tor's
2417   security, and provides client-side support for the microdescriptor
2418   and optimistic data features introduced earlier in the 0.2.3.x
2419   series. It also includes numerous critical bugfixes in the (optional)
2420   bufferevent-based networking backend.
2421
2422   o Major features (stream isolation):
2423     - You can now configure Tor so that streams from different
2424       applications are isolated on different circuits, to prevent an
2425       attacker who sees your streams as they leave an exit node from
2426       linking your sessions to one another. To do this, choose some way
2427       to distinguish the applications: have them connect to different
2428       SocksPorts, or have one of them use SOCKS4 while the other uses
2429       SOCKS5, or have them pass different authentication strings to the
2430       SOCKS proxy. Then, use the new SocksPort syntax to configure the
2431       degree of isolation you need. This implements Proposal 171.
2432     - There's a new syntax for specifying multiple client ports (such as
2433       SOCKSPort, TransPort, DNSPort, NATDPort): you can now just declare
2434       multiple *Port entries with full addr:port syntax on each.
2435       The old *ListenAddress format is still supported, but you can't
2436       mix it with the new *Port syntax.
2437
2438   o Major features (other):
2439     - Enable microdescriptor fetching by default for clients. This allows
2440       clients to download a much smaller amount of directory information.
2441       To disable it (and go back to the old-style consensus and
2442       descriptors), set "UseMicrodescriptors 0" in your torrc file.
2443     - Tor's firewall-helper feature, introduced in 0.2.3.1-alpha (see the
2444       "PortForwarding" config option), now supports Windows.
2445     - When using an exit relay running 0.2.3.x, clients can now
2446       "optimistically" send data before the exit relay reports that
2447       the stream has opened. This saves a round trip when starting
2448       connections where the client speaks first (such as web browsing).
2449       This behavior is controlled by a consensus parameter (currently
2450       disabled). To turn it on or off manually, use the "OptimisticData"
2451       torrc option. Implements proposal 181; code by Ian Goldberg.
2452
2453   o Major bugfixes (bufferevents, fixes on 0.2.3.1-alpha):
2454     - When using IOCP on Windows, we need to enable Libevent windows
2455       threading support.
2456     - The IOCP backend now works even when the user has not specified
2457       the (internal, debugging-only) _UseFilteringSSLBufferevents option.
2458       Fixes part of bug 3752.
2459     - Correctly record the bytes we've read and written when using
2460       bufferevents, so that we can include them in our bandwidth history
2461       and advertised bandwidth. Fixes bug 3803.
2462     - Apply rate-limiting only at the bottom of a chain of filtering
2463       bufferevents. This prevents us from filling up internal read
2464       buffers and violating rate-limits when filtering bufferevents
2465       are enabled. Fixes part of bug 3804.
2466     - Add high-watermarks to the output buffers for filtered
2467       bufferevents. This prevents us from filling up internal write
2468       buffers and wasting CPU cycles when filtering bufferevents are
2469       enabled. Fixes part of bug 3804.
2470     - Correctly notice when data has been written from a bufferevent
2471       without flushing it completely. Fixes bug 3805.
2472     - Fix a bug where server-side tunneled bufferevent-based directory
2473       streams would get closed prematurely. Fixes bug 3814.
2474     - Fix a use-after-free error with per-connection rate-limiting
2475       buckets. Fixes bug 3888.
2476
2477   o Major bugfixes (also part of 0.2.2.31-rc):
2478     - If we're configured to write our ControlPorts to disk, only write
2479       them after switching UID and creating the data directory. This way,
2480       we don't fail when starting up with a nonexistent DataDirectory
2481       and a ControlPortWriteToFile setting based on that directory. Fixes
2482       bug 3747; bugfix on Tor 0.2.2.26-beta.
2483
2484   o Minor features:
2485     - Added a new CONF_CHANGED event so that controllers can be notified
2486       of any configuration changes made by other controllers, or by the
2487       user. Implements ticket 1692.
2488     - Use evbuffer_copyout() in inspect_evbuffer(). This fixes a memory
2489       leak when using bufferevents, and lets Libevent worry about how to
2490       best copy data out of a buffer.
2491     - Replace files in stats/ rather than appending to them. Now that we
2492       include statistics in extra-info descriptors, it makes no sense to
2493       keep old statistics forever. Implements ticket 2930.
2494
2495   o Minor features (build compatibility):
2496     - Limited, experimental support for building with nmake and MSVC.
2497     - Provide a substitute implementation of lround() for MSVC, which
2498       apparently lacks it. Patch from Gisle Vanem.
2499
2500   o Minor features (also part of 0.2.2.31-rc):
2501     - Update to the August 2 2011 Maxmind GeoLite Country database.
2502
2503   o Minor bugfixes (on 0.2.3.x-alpha):
2504     - Fix a spurious warning when parsing SOCKS requests with
2505       bufferevents enabled. Fixes bug 3615; bugfix on 0.2.3.2-alpha.
2506     - Get rid of a harmless warning that could happen on relays running
2507       with bufferevents. The warning was caused by someone doing an http
2508       request to a relay's orport. Also don't warn for a few related
2509       non-errors. Fixes bug 3700; bugfix on 0.2.3.1-alpha.
2510
2511   o Minor bugfixes (on 2.2.x and earlier):
2512     - Correct the man page to explain that HashedControlPassword and
2513       CookieAuthentication can both be set, in which case either method
2514       is sufficient to authenticate to Tor. Bugfix on 0.2.0.7-alpha,
2515       when we decided to allow these config options to both be set. Issue
2516       raised by bug 3898.
2517     - The "--quiet" and "--hush" options now apply not only to Tor's
2518       behavior before logs are configured, but also to Tor's behavior in
2519       the absense of configured logs. Fixes bug 3550; bugfix on
2520       0.2.0.10-alpha.
2521
2522   o Minor bugfixes (also part of 0.2.2.31-rc):
2523     - Write several files in text mode, on OSes that distinguish text
2524       mode from binary mode (namely, Windows). These files are:
2525       'buffer-stats', 'dirreq-stats', and 'entry-stats' on relays
2526       that collect those statistics; 'client_keys' and 'hostname' for
2527       hidden services that use authentication; and (in the tor-gencert
2528       utility) newly generated identity and signing keys. Previously,
2529       we wouldn't specify text mode or binary mode, leading to an
2530       assertion failure. Fixes bug 3607. Bugfix on 0.2.1.1-alpha (when
2531       the DirRecordUsageByCountry option which would have triggered
2532       the assertion failure was added), although this assertion failure
2533       would have occurred in tor-gencert on Windows in 0.2.0.1-alpha.
2534     - Selectively disable deprecation warnings on OS X because Lion
2535       started deprecating the shipped copy of openssl. Fixes bug 3643.
2536     - Remove an extra pair of quotation marks around the error
2537       message in control-port STATUS_GENERAL BUG events. Bugfix on
2538       0.1.2.6-alpha; fixes bug 3732.
2539     - When unable to format an address as a string, report its value
2540       as "???" rather than reusing the last formatted address. Bugfix
2541       on 0.2.1.5-alpha.
2542
2543   o Code simplifications and refactoring:
2544     - Rewrite the listener-selection logic so that parsing which ports
2545       we want to listen on is now separate from binding to the ports
2546       we want.
2547
2548   o Build changes:
2549     - Building Tor with bufferevent support now requires Libevent
2550       2.0.13-stable or later. Previous versions of Libevent had bugs in
2551       SSL-related bufferevents and related issues that would make Tor
2552       work badly with bufferevents. Requiring 2.0.13-stable also allows
2553       Tor with bufferevents to take advantage of Libevent APIs
2554       introduced after 2.0.8-rc.
2555
2556
2557 Changes in version 0.2.2.32 - 2011-08-27
2558   The Tor 0.2.2 release series is dedicated to the memory of Andreas
2559   Pfitzmann (1958-2010), a pioneer in anonymity and privacy research,
2560   a founder of the PETS community, a leader in our field, a mentor,
2561   and a friend. He left us with these words: "I had the possibility
2562   to contribute to this world that is not as it should be. I hope I
2563   could help in some areas to make the world a better place, and that
2564   I could also encourage other people to be engaged in improving the
2565   world. Please, stay engaged. This world needs you, your love, your
2566   initiative -- now I cannot be part of that anymore."
2567
2568   Tor 0.2.2.32, the first stable release in the 0.2.2 branch, is finally
2569   ready. More than two years in the making, this release features improved
2570   client performance and hidden service reliability, better compatibility
2571   for Android, correct behavior for bridges that listen on more than
2572   one address, more extensible and flexible directory object handling,
2573   better reporting of network statistics, improved code security, and
2574   many many other features and bugfixes.
2575
2576
2577 Changes in version 0.2.2.31-rc - 2011-08-17
2578   Tor 0.2.2.31-rc is the second and hopefully final release candidate
2579   for the Tor 0.2.2.x series.
2580
2581   o Major bugfixes:
2582     - Remove an extra pair of quotation marks around the error
2583       message in control-port STATUS_GENERAL BUG events. Bugfix on
2584       0.1.2.6-alpha; fixes bug 3732.
2585     - If we're configured to write our ControlPorts to disk, only write
2586       them after switching UID and creating the data directory. This way,
2587       we don't fail when starting up with a nonexistent DataDirectory
2588       and a ControlPortWriteToFile setting based on that directory. Fixes
2589       bug 3747; bugfix on Tor 0.2.2.26-beta.
2590
2591   o Minor features:
2592     - Update to the August 2 2011 Maxmind GeoLite Country database.
2593
2594   o Minor bugfixes:
2595     - Allow GETINFO fingerprint to return a fingerprint even when
2596       we have not yet built a router descriptor. Fixes bug 3577;
2597       bugfix on 0.2.0.1-alpha.
2598     - Write several files in text mode, on OSes that distinguish text
2599       mode from binary mode (namely, Windows). These files are:
2600       'buffer-stats', 'dirreq-stats', and 'entry-stats' on relays
2601       that collect those statistics; 'client_keys' and 'hostname' for
2602       hidden services that use authentication; and (in the tor-gencert
2603       utility) newly generated identity and signing keys. Previously,
2604       we wouldn't specify text mode or binary mode, leading to an
2605       assertion failure. Fixes bug 3607. Bugfix on 0.2.1.1-alpha (when
2606       the DirRecordUsageByCountry option which would have triggered
2607       the assertion failure was added), although this assertion failure
2608       would have occurred in tor-gencert on Windows in 0.2.0.1-alpha.
2609     - Selectively disable deprecation warnings on OS X because Lion
2610       started deprecating the shipped copy of openssl. Fixes bug 3643.
2611     - When unable to format an address as a string, report its value
2612       as "???" rather than reusing the last formatted address. Bugfix
2613       on 0.2.1.5-alpha.
2614
2615
2616 Changes in version 0.2.3.2-alpha - 2011-07-18
2617   Tor 0.2.3.2-alpha introduces two new experimental features:
2618   microdescriptors and pluggable transports. It also continues cleaning
2619   up a variety of recently introduced features.
2620
2621   o Major features:
2622     - Clients can now use microdescriptors instead of regular descriptors
2623       to build circuits. Microdescriptors are authority-generated
2624       summaries of regular descriptors' contents, designed to change
2625       very rarely (see proposal 158 for details). This feature is
2626       designed to save bandwidth, especially for clients on slow internet
2627       connections. It's off by default for now, since nearly no caches
2628       support it, but it will be on-by-default for clients in a future
2629       version. You can use the UseMicrodescriptors option to turn it on.
2630     - Tor clients using bridges can now be configured to use a separate
2631       'transport' proxy for each bridge. This approach helps to resist
2632       censorship by allowing bridges to use protocol obfuscation
2633       plugins. It implements part of proposal 180. Implements ticket 2841.
2634     - While we're trying to bootstrap, record how many TLS connections
2635       fail in each state, and report which states saw the most failures
2636       in response to any bootstrap failures. This feature may speed up
2637       diagnosis of censorship events. Implements ticket 3116.
2638
2639   o Major bugfixes (on 0.2.3.1-alpha):
2640     - When configuring a large set of nodes in EntryNodes (as with
2641       'EntryNodes {cc}' or 'EntryNodes 1.1.1.1/16'), choose only a
2642       random subset to be guards, and choose them in random
2643       order. Fixes bug 2798.
2644     - Tor could crash when remembering a consensus in a non-used consensus
2645       flavor without having a current consensus set. Fixes bug 3361.
2646     - Comparing an unknown address to a microdescriptor's shortened exit
2647       policy would always give a "rejected" result. Fixes bug 3599.
2648     - Using microdescriptors as a client no longer prevents Tor from
2649       uploading and downloading hidden service descriptors. Fixes
2650       bug 3601.
2651
2652   o Minor features:
2653     - Allow nameservers with IPv6 address. Resolves bug 2574.
2654     - Accept attempts to include a password authenticator in the
2655       handshake, as supported by SOCKS5. This handles SOCKS clients that
2656       don't know how to omit a password when authenticating. Resolves
2657       bug 1666.
2658     - When configuring a large set of nodes in EntryNodes, and there are
2659       enough of them listed as Guard so that we don't need to consider
2660       the non-guard entries, prefer the ones listed with the Guard flag.
2661     - Check for and recover from inconsistency in the microdescriptor
2662       cache. This will make it harder for us to accidentally free a
2663       microdescriptor without removing it from the appropriate data
2664       structures. Fixes issue 3135; issue noted by "wanoskarnet".
2665     - Log SSL state transitions at log level DEBUG, log domain
2666       HANDSHAKE. This can be useful for debugging censorship events.
2667       Implements ticket 3264.
2668     - Add port 6523 (Gobby) to LongLivedPorts. Patch by intrigeri;
2669       implements ticket 3439.
2670
2671   o Minor bugfixes (on 0.2.3.1-alpha):
2672     - Do not free all general-purpose regular descriptors just
2673       because microdescriptor use is enabled. Fixes bug 3113.
2674     - Correctly link libevent_openssl when --enable-static-libevent
2675       is passed to configure. Fixes bug 3118.
2676     - Bridges should not complain during their heartbeat log messages that
2677       they are unlisted in the consensus: that's more or less the point
2678       of being a bridge. Fixes bug 3183.
2679     - Report a SIGNAL event to controllers when acting on a delayed
2680       SIGNAL NEWNYM command. Previously, we would report a SIGNAL
2681       event to the controller if we acted on a SIGNAL NEWNYM command
2682       immediately, and otherwise not report a SIGNAL event for the
2683       command at all. Fixes bug 3349.
2684     - Fix a crash when handling the SIGNAL controller command or
2685       reporting ERR-level status events with bufferevents enabled. Found
2686       by Robert Ransom. Fixes bug 3367.
2687     - Always ship the tor-fw-helper manpage in our release tarballs.
2688       Fixes bug 3389. Reported by Stephen Walker.
2689     - Fix a class of double-mark-for-close bugs when bufferevents
2690       are enabled. Fixes bug 3403.
2691     - Update tor-fw-helper to support libnatpmp-20110618. Fixes bug 3434.
2692     - Add SIGNAL to the list returned by the 'GETINFO events/names'
2693       control-port command. Fixes part of bug 3465.
2694     - Prevent using negative indices during unit test runs when read_all()
2695       fails. Spotted by coverity.
2696     - Fix a rare memory leak when checking the nodelist without it being
2697       present. Found by coverity.
2698     - Only try to download a microdescriptor-flavored consensus from
2699       a directory cache that provides them.
2700
2701   o Minor bugfixes (on 0.2.2.x and earlier):
2702     - Assert that hidden-service-related operations are not performed
2703       using single-hop circuits. Previously, Tor would assert that
2704       client-side streams are not attached to single-hop circuits,
2705       but not that other sensitive operations on the client and service
2706       side are not performed using single-hop circuits. Fixes bug 3332;
2707       bugfix on 0.0.6.
2708     - Don't publish a new relay descriptor when we reload our onion key,
2709       unless the onion key has actually changed. Fixes bug 3263 and
2710       resolves another cause of bug 1810. Bugfix on 0.1.1.11-alpha.
2711     - Allow GETINFO fingerprint to return a fingerprint even when
2712       we have not yet built a router descriptor. Fixes bug 3577;
2713       bugfix on 0.2.0.1-alpha.
2714     - Make 'tor --digests' list hashes of all Tor source files. Bugfix
2715       on 0.2.2.4-alpha; fixes bug 3427.
2716
2717   o Code simplification and refactoring:
2718     - Use tor_sscanf() in place of scanf() in more places through the
2719       code. This makes us a little more locale-independent, and
2720       should help shut up code-analysis tools that can't tell
2721       a safe sscanf string from a dangerous one.
2722     - Use tt_assert(), not tor_assert(), for checking for test failures.
2723       This makes the unit tests more able to go on in the event that
2724       one of them fails.
2725     - Split connection_about_to_close() into separate functions for each
2726       connection type.
2727
2728   o Build changes:
2729     - On Windows, we now define the _WIN32_WINNT macros only if they
2730       are not already defined. This lets the person building Tor decide,
2731       if they want, to require a later version of Windows.
2732
2733
2734 Changes in version 0.2.2.30-rc - 2011-07-07
2735   Tor 0.2.2.30-rc is the first release candidate for the Tor 0.2.2.x
2736   series. It fixes a few smaller bugs, but generally appears stable.
2737   Please test it and let us know whether it is!
2738
2739   o Minor bugfixes:
2740     - Send a SUCCEEDED stream event to the controller when a reverse
2741       resolve succeeded. Fixes bug 3536; bugfix on 0.0.8pre1. Issue
2742       discovered by katmagic.
2743     - Always NUL-terminate the sun_path field of a sockaddr_un before
2744       passing it to the kernel. (Not a security issue: kernels are
2745       smart enough to reject bad sockaddr_uns.) Found by Coverity;
2746       CID #428. Bugfix on Tor 0.2.0.3-alpha.
2747     - Don't stack-allocate the list of supplementary GIDs when we're
2748       about to log them. Stack-allocating NGROUPS_MAX gid_t elements
2749       could take up to 256K, which is way too much stack. Found by
2750       Coverity; CID #450. Bugfix on 0.2.1.7-alpha.
2751     - Add BUILDTIMEOUT_SET to the list returned by the 'GETINFO
2752       events/names' control-port command. Bugfix on 0.2.2.9-alpha;
2753       fixes part of bug 3465.
2754     - Fix a memory leak when receiving a descriptor for a hidden
2755       service we didn't ask for. Found by Coverity; CID #30. Bugfix
2756       on 0.2.2.26-beta.
2757
2758   o Minor features:
2759     - Update to the July 1 2011 Maxmind GeoLite Country database.
2760
2761
2762 Changes in version 0.2.2.29-beta - 2011-06-20
2763   Tor 0.2.2.29-beta reverts an accidental behavior change for users who
2764   have bridge lines in their torrc but don't want to use them; gets
2765   us closer to having the control socket feature working on Debian;
2766   and fixes a variety of smaller bugs.
2767
2768   o Major bugfixes:
2769     - Revert the UseBridges option to its behavior before 0.2.2.28-beta.
2770       When we changed the default behavior to "use bridges if any
2771       are listed in the torrc", we surprised users who had bridges
2772       in their torrc files but who didn't actually want to use them.
2773       Partial resolution for bug 3354.
2774
2775   o Privacy fixes:
2776     - Don't attach new streams to old rendezvous circuits after SIGNAL
2777       NEWNYM. Previously, we would keep using an existing rendezvous
2778       circuit if it remained open (i.e. if it were kept open by a
2779       long-lived stream, or if a new stream were attached to it before
2780       Tor could notice that it was old and no longer in use). Bugfix on
2781       0.1.1.15-rc; fixes bug 3375.
2782
2783   o Minor bugfixes:
2784     - Fix a bug when using ControlSocketsGroupWritable with User. The
2785       directory's group would be checked against the current group, not
2786       the configured group. Patch by Jérémy Bobbio. Fixes bug 3393;
2787       bugfix on 0.2.2.26-beta.
2788     - Make connection_printf_to_buf()'s behaviour sane. Its callers
2789       expect it to emit a CRLF iff the format string ends with CRLF;
2790       it actually emitted a CRLF iff (a) the format string ended with
2791       CRLF or (b) the resulting string was over 1023 characters long or
2792       (c) the format string did not end with CRLF *and* the resulting
2793       string was 1021 characters long or longer. Bugfix on 0.1.1.9-alpha;
2794       fixes part of bug 3407.
2795     - Make send_control_event_impl()'s behaviour sane. Its callers
2796       expect it to always emit a CRLF at the end of the string; it
2797       might have emitted extra control characters as well. Bugfix on
2798       0.1.1.9-alpha; fixes another part of bug 3407.
2799     - Make crypto_rand_int() check the value of its input correctly.
2800       Previously, it accepted values up to UINT_MAX, but could return a
2801       negative number if given a value above INT_MAX+1. Found by George
2802       Kadianakis. Fixes bug 3306; bugfix on 0.2.2pre14.
2803     - Avoid a segfault when reading a malformed circuit build state
2804       with more than INT_MAX entries. Found by wanoskarnet. Bugfix on
2805       0.2.2.4-alpha.
2806     - When asked about a DNS record type we don't support via a
2807       client DNSPort, reply with NOTIMPL rather than an empty
2808       reply. Patch by intrigeri. Fixes bug 3369; bugfix on 2.0.1-alpha.
2809     - Fix a rare memory leak during stats writing. Found by coverity.
2810
2811   o Minor features:
2812     - Update to the June 1 2011 Maxmind GeoLite Country database.
2813
2814   o Code simplifications and refactoring:
2815     - Remove some dead code as indicated by coverity.
2816     - Remove a few dead assignments during router parsing. Found by
2817       coverity.
2818     - Add some forgotten return value checks during unit tests. Found
2819       by coverity.
2820     - Don't use 1-bit wide signed bit fields. Found by coverity.
2821
2822
2823 Changes in version 0.2.2.28-beta - 2011-06-04
2824   Tor 0.2.2.28-beta makes great progress towards a new stable release: we
2825   fixed a big bug in whether relays stay in the consensus consistently,
2826   we moved closer to handling bridges and hidden services correctly,
2827   and we started the process of better handling the dreaded "my Vidalia
2828   died, and now my Tor demands a password when I try to reconnect to it"
2829   usability issue.
2830
2831   o Major bugfixes:
2832     - Don't decide to make a new descriptor when receiving a HUP signal.
2833       This bug has caused a lot of 0.2.2.x relays to disappear from the
2834       consensus periodically. Fixes the most common case of triggering
2835       bug 1810; bugfix on 0.2.2.7-alpha.
2836     - Actually allow nameservers with IPv6 addresses. Fixes bug 2574.
2837     - Don't try to build descriptors if "ORPort auto" is set and we
2838       don't know our actual ORPort yet. Fix for bug 3216; bugfix on
2839       0.2.2.26-beta.
2840     - Resolve a crash that occurred when setting BridgeRelay to 1 with
2841       accounting enabled. Fixes bug 3228; bugfix on 0.2.2.18-alpha.
2842     - Apply circuit timeouts to opened hidden-service-related circuits
2843       based on the correct start time. Previously, we would apply the
2844       circuit build timeout based on time since the circuit's creation;
2845       it was supposed to be applied based on time since the circuit
2846       entered its current state. Bugfix on 0.0.6; fixes part of bug 1297.
2847     - Use the same circuit timeout for client-side introduction
2848       circuits as for other four-hop circuits, rather than the timeout
2849       for single-hop directory-fetch circuits; the shorter timeout may
2850       have been appropriate with the static circuit build timeout in
2851       0.2.1.x and earlier, but caused many hidden service access attempts
2852       to fail with the adaptive CBT introduced in 0.2.2.2-alpha. Bugfix
2853       on 0.2.2.2-alpha; fixes another part of bug 1297.
2854     - In ticket 2511 we fixed a case where you could use an unconfigured
2855       bridge if you had configured it as a bridge the last time you ran
2856       Tor. Now fix another edge case: if you had configured it as a bridge
2857       but then switched to a different bridge via the controller, you
2858       would still be willing to use the old one. Bugfix on 0.2.0.1-alpha;
2859       fixes bug 3321.
2860
2861   o Major features:
2862     - Add an __OwningControllerProcess configuration option and a
2863       TAKEOWNERSHIP control-port command. Now a Tor controller can ensure
2864       that when it exits, Tor will shut down. Implements feature 3049.
2865     - If "UseBridges 1" is set and no bridges are configured, Tor will
2866       now refuse to build any circuits until some bridges are set.
2867       If "UseBridges auto" is set, Tor will use bridges if they are
2868       configured and we are not running as a server, but otherwise will
2869       make circuits as usual. The new default is "auto". Patch by anonym,
2870       so the Tails LiveCD can stop automatically revealing you as a Tor
2871       user on startup.
2872
2873   o Minor bugfixes:
2874     - Fix warnings from GCC 4.6's "-Wunused-but-set-variable" option.
2875     - Remove a trailing asterisk from "exit-policy/default" in the
2876       output of the control port command "GETINFO info/names". Bugfix
2877       on 0.1.2.5-alpha.
2878     - Use a wide type to hold sockets when built for 64-bit Windows builds.
2879       Fixes bug 3270.
2880     - Warn when the user configures two HiddenServiceDir lines that point
2881       to the same directory. Bugfix on 0.0.6 (the version introducing
2882       HiddenServiceDir); fixes bug 3289.
2883     - Remove dead code from rend_cache_lookup_v2_desc_as_dir. Fixes
2884       part of bug 2748; bugfix on 0.2.0.10-alpha.
2885     - Log malformed requests for rendezvous descriptors as protocol
2886       warnings, not warnings. Also, use a more informative log message
2887       in case someone sees it at log level warning without prior
2888       info-level messages. Fixes the other part of bug 2748; bugfix
2889       on 0.2.0.10-alpha.
2890     - Clear the table recording the time of the last request for each
2891       hidden service descriptor from each HS directory on SIGNAL NEWNYM.
2892       Previously, we would clear our HS descriptor cache on SIGNAL
2893       NEWNYM, but if we had previously retrieved a descriptor (or tried
2894       to) from every directory responsible for it, we would refuse to
2895       fetch it again for up to 15 minutes. Bugfix on 0.2.2.25-alpha;
2896       fixes bug 3309.
2897     - Fix a log message that said "bits" while displaying a value in
2898       bytes. Found by wanoskarnet. Fixes bug 3318; bugfix on
2899       0.2.0.1-alpha.
2900     - When checking for 1024-bit keys, check for 1024 bits, not 128
2901       bytes. This allows Tor to correctly discard keys of length 1017
2902       through 1023. Bugfix on 0.0.9pre5.
2903
2904   o Minor features:
2905     - Relays now log the reason for publishing a new relay descriptor,
2906       so we have a better chance of hunting down instances of bug 1810.
2907       Resolves ticket 3252.
2908     - Revise most log messages that refer to nodes by nickname to
2909       instead use the "$key=nickname at address" format. This should be
2910       more useful, especially since nicknames are less and less likely
2911       to be unique. Resolves ticket 3045.
2912     - Log (at info level) when purging pieces of hidden-service-client
2913       state because of SIGNAL NEWNYM.
2914
2915   o Removed options:
2916     - Remove undocumented option "-F" from tor-resolve: it hasn't done
2917       anything since 0.2.1.16-rc.
2918
2919
2920 Changes in version 0.2.2.27-beta - 2011-05-18
2921   Tor 0.2.2.27-beta fixes a bridge-related stability bug in the previous
2922   release, and also adds a few more general bugfixes.
2923
2924   o Major bugfixes:
2925     - Fix a crash bug when changing bridges in a running Tor process.
2926       Fixes bug 3213; bugfix on 0.2.2.26-beta.
2927     - When the controller configures a new bridge, don't wait 10 to 60
2928       seconds before trying to fetch its descriptor. Bugfix on
2929       0.2.0.3-alpha; fixes bug 3198 (suggested by 2355).
2930
2931   o Minor bugfixes:
2932     - Require that onion keys have exponent 65537 in microdescriptors too.
2933       Fixes more of bug 3207; bugfix on 0.2.2.26-beta.
2934     - Tor used to limit HttpProxyAuthenticator values to 48 characters.
2935       Changed the limit to 512 characters by removing base64 newlines.
2936       Fixes bug 2752. Fix by Michael Yakubovich.
2937     - When a client starts or stops using bridges, never use a circuit
2938       that was built before the configuration change. This behavior could
2939       put at risk a user who uses bridges to ensure that her traffic
2940       only goes to the chosen addresses. Bugfix on 0.2.0.3-alpha; fixes
2941       bug 3200.
2942
2943
2944 Changes in version 0.2.2.26-beta - 2011-05-17
2945   Tor 0.2.2.26-beta fixes a variety of potential privacy problems. It
2946   also introduces a new "socksport auto" approach that should make it
2947   easier to run multiple Tors on the same system, and does a lot of
2948   cleanup to get us closer to a release candidate.
2949
2950   o Security/privacy fixes:
2951     - Replace all potentially sensitive memory comparison operations
2952       with versions whose runtime does not depend on the data being
2953       compared. This will help resist a class of attacks where an
2954       adversary can use variations in timing information to learn
2955       sensitive data. Fix for one case of bug 3122. (Safe memcmp
2956       implementation by Robert Ransom based partially on code by DJB.)
2957     - When receiving a hidden service descriptor, check that it is for
2958       the hidden service we wanted. Previously, Tor would store any
2959       hidden service descriptors that a directory gave it, whether it
2960       wanted them or not. This wouldn't have let an attacker impersonate
2961       a hidden service, but it did let directories pre-seed a client
2962       with descriptors that it didn't want. Bugfix on 0.0.6.
2963     - On SIGHUP, do not clear out all TrackHostExits mappings, client
2964       DNS cache entries, and virtual address mappings: that's what
2965       NEWNYM is for. Fixes bug 1345; bugfix on 0.1.0.1-rc.
2966
2967   o Major features:
2968     - The options SocksPort, ControlPort, and so on now all accept a
2969       value "auto" that opens a socket on an OS-selected port. A
2970       new ControlPortWriteToFile option tells Tor to write its
2971       actual control port or ports to a chosen file. If the option
2972       ControlPortFileGroupReadable is set, the file is created as
2973       group-readable. Now users can run two Tor clients on the same
2974       system without needing to manually mess with parameters. Resolves
2975       part of ticket 3076.
2976     - Set SO_REUSEADDR on all sockets, not just listeners. This should
2977       help busy exit nodes avoid running out of useable ports just
2978       because all the ports have been used in the near past. Resolves
2979       issue 2850.
2980
2981   o Minor features:
2982     - New "GETINFO net/listeners/(type)" controller command to return
2983       a list of addresses and ports that are bound for listeners for a
2984       given connection type. This is useful when the user has configured
2985       "SocksPort auto" and the controller needs to know which port got
2986       chosen. Resolves another part of ticket 3076.
2987     - Add a new ControlSocketsGroupWritable configuration option: when
2988       it is turned on, ControlSockets are group-writeable by the default
2989       group of the current user. Patch by Jérémy Bobbio; implements
2990       ticket 2972.
2991     - Tor now refuses to create a ControlSocket in a directory that is
2992       world-readable (or group-readable if ControlSocketsGroupWritable
2993       is 0). This is necessary because some operating systems do not
2994       enforce permissions on an AF_UNIX sockets. Permissions on the
2995       directory holding the socket, however, seems to work everywhere.
2996     - Rate-limit a warning about failures to download v2 networkstatus
2997       documents. Resolves part of bug 1352.
2998     - Backport code from 0.2.3.x that allows directory authorities to
2999       clean their microdescriptor caches. Needed to resolve bug 2230.
3000     - When an HTTPS proxy reports "403 Forbidden", we now explain
3001       what it means rather than calling it an unexpected status code.
3002       Closes bug 2503. Patch from Michael Yakubovich.
3003     - Update to the May 1 2011 Maxmind GeoLite Country database.
3004
3005   o Minor bugfixes:
3006     - Authorities now clean their microdesc cache periodically and when
3007       reading from disk initially, not only when adding new descriptors.
3008       This prevents a bug where we could lose microdescriptors. Bugfix
3009       on 0.2.2.6-alpha. Fixes bug 2230.
3010     - Do not crash when our configuration file becomes unreadable, for
3011       example due to a permissions change, between when we start up
3012       and when a controller calls SAVECONF. Fixes bug 3135; bugfix
3013       on 0.0.9pre6.
3014     - Avoid a bug that would keep us from replacing a microdescriptor
3015       cache on Windows. (We would try to replace the file while still
3016       holding it open. That's fine on Unix, but Windows doesn't let us
3017       do that.) Bugfix on 0.2.2.6-alpha; bug found by wanoskarnet.
3018     - Add missing explanations for the authority-related torrc options
3019       RephistTrackTime, BridgePassword, and V3AuthUseLegacyKey in the
3020       man page. Resolves issue 2379.
3021     - As an authority, do not upload our own vote or signature set to
3022       ourself. It would tell us nothing new, and as of 0.2.2.24-alpha,
3023       it would get flagged as a duplicate. Resolves bug 3026.
3024     - Accept hidden service descriptors if we think we might be a hidden
3025       service directory, regardless of what our consensus says. This
3026       helps robustness, since clients and hidden services can sometimes
3027       have a more up-to-date view of the network consensus than we do,
3028       and if they think that the directory authorities list us a HSDir,
3029       we might actually be one. Related to bug 2732; bugfix on
3030       0.2.0.10-alpha.
3031     - When a controller changes TrackHostExits, remove mappings for
3032       hosts that should no longer have their exits tracked. Bugfix on
3033       0.1.0.1-rc.
3034     - When a controller changes VirtualAddrNetwork, remove any mappings
3035       for hosts that were automapped to the old network. Bugfix on
3036       0.1.1.19-rc.
3037     - When a controller changes one of the AutomapHosts* options, remove
3038       any mappings for hosts that should no longer be automapped. Bugfix
3039       on 0.2.0.1-alpha.
3040     - Do not reset the bridge descriptor download status every time we
3041       re-parse our configuration or get a configuration change. Fixes
3042       bug 3019; bugfix on 0.2.0.3-alpha.
3043
3044   o Minor bugfixes (code cleanup):
3045     - When loading the microdesc journal, remember its current size.
3046       In 0.2.2, this helps prevent the microdesc journal from growing
3047       without limit on authorities (who are the only ones to use it in
3048       0.2.2). Fixes a part of bug 2230; bugfix on 0.2.2.6-alpha.
3049       Fix posted by "cypherpunks."
3050     - The microdesc journal is supposed to get rebuilt only if it is
3051       at least _half_ the length of the store, not _twice_ the length
3052       of the store. Bugfix on 0.2.2.6-alpha; fixes part of bug 2230.
3053     - Fix a potential null-pointer dereference while computing a
3054       consensus. Bugfix on tor-0.2.0.3-alpha, found with the help of
3055       clang's analyzer.
3056     - Avoid a possible null-pointer dereference when rebuilding the mdesc
3057       cache without actually having any descriptors to cache. Bugfix on
3058       0.2.2.6-alpha. Issue discovered using clang's static analyzer.
3059     - If we fail to compute the identity digest of a v3 legacy keypair,
3060       warn, and don't use a buffer-full of junk instead. Bugfix on
3061       0.2.1.1-alpha; fixes bug 3106.
3062     - Resolve an untriggerable issue in smartlist_string_num_isin(),
3063       where if the function had ever in the future been used to check
3064       for the presence of a too-large number, it would have given an
3065       incorrect result. (Fortunately, we only used it for 16-bit
3066       values.) Fixes bug 3175; bugfix on 0.1.0.1-rc.
3067     - Require that introduction point keys and onion handshake keys
3068       have a public exponent of 65537. Starts to fix bug 3207; bugfix
3069       on 0.2.0.10-alpha.
3070
3071   o Removed features:
3072     - Caches no longer download and serve v2 networkstatus documents
3073       unless FetchV2Networkstatus flag is set: these documents haven't
3074       haven't been used by clients or relays since 0.2.0.x. Resolves
3075       bug 3022.
3076
3077
3078 Changes in version 0.2.3.1-alpha - 2011-05-05
3079   Tor 0.2.3.1-alpha adds some new experimental features, including support
3080   for an improved network IO backend, IOCP networking on Windows,
3081   microdescriptor caching, "fast-start" support for streams, and automatic
3082   home router configuration. There are also numerous internal improvements
3083   to try to make the code easier for developers to work with.
3084
3085   This is the first alpha release in a new series, so expect there to be
3086   bugs. Users who would rather test out a more stable branch should
3087   stay with 0.2.2.x for now.
3088
3089   o Major features:
3090     - Tor can now optionally build with the "bufferevents" buffered IO
3091       backend provided by Libevent 2. To use this feature, make sure you
3092       have the latest possible version of Libevent, and pass the
3093       --enable-bufferevents flag to configure when building Tor from
3094       source. This feature will make our networking code more flexible,
3095       let us stack layers on each other, and let us use more efficient
3096       zero-copy transports where available.
3097     - As an experimental feature, Tor can use IOCP for networking on Windows.
3098       Once this code is tuned and optimized, it promises much better
3099       performance than the select-based backend we've used in the past. To
3100       try this feature, you must build Tor with Libevent 2, configure Tor
3101       with the "bufferevents" buffered IO backend, and add "DisableIOCP 0" to
3102       your torrc. There are known bugs here: only try this if you can help
3103       debug it as it breaks.
3104     - The EntryNodes option can now include country codes like {de} or IP
3105       addresses or network masks. Previously we had disallowed these options
3106       because we didn't have an efficient way to keep the list up to
3107       date. Fixes bug 1982, but see bug 2798 for an unresolved issue here.
3108     - Exit nodes now accept and queue data on not-yet-connected streams.
3109       Previously, the client wasn't allowed to send data until the stream was
3110       connected, which slowed down all connections. This change will enable
3111       clients to perform a "fast-start" on streams and send data without
3112       having to wait for a confirmation that the stream has opened. (Patch
3113       from Ian Goldberg; implements the server side of Proposal 174.)
3114     - Tor now has initial support for automatic port mapping on the many
3115       home routers that support NAT-PMP or UPnP. (Not yet supported on
3116       Windows). To build the support code, you'll need to have libnatpnp
3117       library and/or the libminiupnpc library, and you'll need to enable the
3118       feature specifically by passing "--enable-upnp" and/or
3119       "--enable-natpnp" to configure. To turn it on, use the new
3120       PortForwarding option.
3121     - Caches now download, cache, and serve multiple "flavors" of the
3122       consensus, including a flavor that describes microdescriptors.
3123     - Caches now download, cache, and serve microdescriptors -- small
3124       summaries of router descriptors that are authenticated by all of the
3125       directory authorities. Once enough caches are running this code,
3126       clients will be able to save significant amounts of directory bandwidth
3127       by downloading microdescriptors instead of router descriptors.
3128
3129   o Minor features:
3130     - Make logging resolution configurable with a new LogTimeGranularity
3131       option, and change the default from 1 millisecond to 1 second.
3132       Implements enhancement 1668.
3133     - We log which torrc file we're using on startup. Implements ticket
3134       2444.
3135     - Ordinarily, Tor does not count traffic from private addresses (like
3136       127.0.0.1 or 10.0.0.1) when calculating rate limits or accounting.
3137       There is now a new option, CountPrivateBandwidth, to disable this
3138       behavior. Patch from Daniel Cagara.
3139     - New --enable-static-tor configure option for building Tor as
3140       statically as possible. Idea, general hackery and thoughts from
3141       Alexei Czeskis, John Gilmore, Jacob Appelbaum. Implements ticket
3142       2702.
3143     - If you set the NumCPUs option to 0, Tor will now try to detect how
3144       many CPUs you have. This is the new default behavior.
3145     - Turn on directory request statistics by default and include them in
3146       extra-info descriptors. Don't break if we have no GeoIP database.
3147     - Relays that set "ConnDirectionStatistics 1" write statistics on the
3148       bidirectional use of connections to disk every 24 hours.
3149     - Add a GeoIP file digest to the extra-info descriptor. Implements
3150       enhancement 1883.
3151     - The NodeFamily option -- which let you declare that you want to
3152       consider nodes to be part of a family whether they list themselves
3153       that way or not -- now allows IP address ranges and country codes.
3154     - Add a new 'Heartbeat' log message type to periodically log a message
3155       describing Tor's status at level Notice. This feature is meant for
3156       operators who log at notice, and want to make sure that their Tor
3157       server is still working. Implementation by George Kadianakis.
3158
3159   o Minor bugfixes (on 0.2.2.25-alpha):
3160     - When loading the microdesc journal, remember its current size.
3161       In 0.2.2, this helps prevent the microdesc journal from growing
3162       without limit on authorities (who are the only ones to use it in
3163       0.2.2). Fixes a part of bug 2230; bugfix on 0.2.2.6-alpha.
3164       Fix posted by "cypherpunks."
3165     - The microdesc journal is supposed to get rebuilt only if it is
3166       at least _half_ the length of the store, not _twice_ the length
3167       of the store. Bugfix on 0.2.2.6-alpha; fixes part of bug 2230.
3168     - If as an authority we fail to compute the identity digest of a v3
3169       legacy keypair, warn, and don't use a buffer-full of junk instead.
3170       Bugfix on 0.2.1.1-alpha; fixes bug 3106.
3171     - Authorities now clean their microdesc cache periodically and when
3172       reading from disk initially, not only when adding new descriptors.
3173       This prevents a bug where we could lose microdescriptors. Bugfix
3174       on 0.2.2.6-alpha.
3175
3176   o Minor features (controller):
3177     - Add a new SIGNAL event to the controller interface so that
3178       controllers can be notified when Tor handles a signal. Resolves
3179       issue 1955. Patch by John Brooks.
3180     - Add a new GETINFO option to get total bytes read and written. Patch
3181       from pipe, revised by atagar. Resolves ticket 2345.
3182     - Implement some GETINFO controller fields to provide information about
3183       the Tor process's pid, euid, username, and resource limits.
3184
3185   o Build changes:
3186     - Our build system requires automake 1.6 or later to create the
3187       Makefile.in files. Previously, you could have used 1.4.
3188       This only affects developers and people building Tor from git;
3189       people who build Tor from the source distribution without changing
3190       the Makefile.am files should be fine.
3191     - Our autogen.sh script uses autoreconf to launch autoconf, automake, and
3192       so on. This is more robust against some of the failure modes
3193       associated with running the autotools pieces on their own.
3194
3195   o Minor packaging issues:
3196     - On OpenSUSE, create the /var/run/tor directory on startup if it is not
3197       already created. Patch from Andreas Stieger. Fixes bug 2573.
3198
3199   o Code simplifications and refactoring:
3200     - A major revision to our internal node-selecting and listing logic.
3201       Tor already had at least two major ways to look at the question of
3202       "which Tor servers do we know about": a list of router descriptors,
3203       and a list of entries in the current consensus. With
3204       microdescriptors, we're adding a third. Having so many systems
3205       without an abstraction layer over them was hurting the codebase.
3206       Now, we have a new "node_t" abstraction that presents a consistent
3207       interface to a client's view of a Tor node, and holds (nearly) all
3208       of the mutable state formerly in routerinfo_t and routerstatus_t.
3209     - The helper programs tor-gencert, tor-resolve, and tor-checkkey
3210       no longer link against Libevent: they never used it, but
3211       our library structure used to force them to link it.
3212
3213   o Removed features:
3214     - Remove some old code to work around even older versions of Tor that
3215       used forked processes to handle DNS requests. Such versions of Tor
3216       are no longer in use as servers.
3217
3218   o Documentation fixes:
3219     - Correct a broken faq link in the INSTALL file. Fixes bug 2307.
3220     - Add missing documentation for the authority-related torrc options
3221       RephistTrackTime, BridgePassword, and V3AuthUseLegacyKey. Resolves
3222       issue 2379.
3223
3224
3225 Changes in version 0.2.2.25-alpha - 2011-04-29
3226   Tor 0.2.2.25-alpha fixes many bugs: hidden service clients are more
3227   robust, routers no longer overreport their bandwidth, Win7 should crash
3228   a little less, and NEWNYM (as used by Vidalia's "new identity" button)
3229   now prevents hidden service-related activity from being linkable. It
3230   provides more information to Vidalia so you can see if your bridge is
3231   working. Also, 0.2.2.25-alpha revamps the Entry/Exit/ExcludeNodes and
3232   StrictNodes configuration options to make them more reliable, more
3233   understandable, and more regularly applied. If you use those options,
3234   please see the revised documentation for them in the manual page.
3235
3236   o Major bugfixes:
3237     - Relays were publishing grossly inflated bandwidth values because
3238       they were writing their state files wrong--now they write the
3239       correct value. Also, resume reading bandwidth history from the
3240       state file correctly. Fixes bug 2704; bugfix on 0.2.2.23-alpha.
3241     - Improve hidden service robustness: When we find that we have
3242       extended a hidden service's introduction circuit to a relay not
3243       listed as an introduction point in the HS descriptor we currently
3244       have, retry with an introduction point from the current
3245       descriptor. Previously we would just give up. Fixes bugs 1024 and
3246       1930; bugfix on 0.2.0.10-alpha.
3247     - Clients now stop trying to use an exit node associated with a given
3248       destination by TrackHostExits if they fail to reach that exit node.
3249       Fixes bug 2999. Bugfix on 0.2.0.20-rc.
3250     - Fix crash bug on platforms where gmtime and localtime can return
3251       NULL. Windows 7 users were running into this one. Fixes part of bug
3252       2077. Bugfix on all versions of Tor. Found by boboper.
3253
3254   o Security and stability fixes:
3255     - Don't double-free a parsable, but invalid, microdescriptor, even if
3256       it is followed in the blob we're parsing by an unparsable
3257       microdescriptor. Fixes an issue reported in a comment on bug 2954.
3258       Bugfix on 0.2.2.6-alpha; fix by "cypherpunks".
3259     - If the Nickname configuration option isn't given, Tor would pick a
3260       nickname based on the local hostname as the nickname for a relay.
3261       Because nicknames are not very important in today's Tor and the
3262       "Unnamed" nickname has been implemented, this is now problematic
3263       behavior: It leaks information about the hostname without being
3264       useful at all. Fixes bug 2979; bugfix on 0.1.2.2-alpha, which
3265       introduced the Unnamed nickname. Reported by tagnaq.
3266     - Fix an uncommon assertion failure when running with DNSPort under
3267       heavy load. Fixes bug 2933; bugfix on 0.2.0.1-alpha.
3268     - Avoid linkability based on cached hidden service descriptors: forget
3269       all hidden service descriptors cached as a client when processing a
3270       SIGNAL NEWNYM command. Fixes bug 3000; bugfix on 0.0.6.
3271
3272   o Major features:
3273     - Export GeoIP information on bridge usage to controllers even if we
3274       have not yet been running for 24 hours. Now Vidalia bridge operators
3275       can get more accurate and immediate feedback about their
3276       contributions to the network.
3277
3278   o Major features and bugfixes (node selection):
3279     - Revise and reconcile the meaning of the ExitNodes, EntryNodes,
3280       ExcludeEntryNodes, ExcludeExitNodes, ExcludeNodes, and StrictNodes
3281       options. Previously, we had been ambiguous in describing what
3282       counted as an "exit" node, and what operations exactly "StrictNodes
3283       0" would permit. This created confusion when people saw nodes built
3284       through unexpected circuits, and made it hard to tell real bugs from
3285       surprises. Now the intended behavior is:
3286         . "Exit", in the context of ExitNodes and ExcludeExitNodes, means
3287           a node that delivers user traffic outside the Tor network.
3288         . "Entry", in the context of EntryNodes, means a node used as the
3289           first hop of a multihop circuit. It doesn't include direct
3290           connections to directory servers.
3291         . "ExcludeNodes" applies to all nodes.
3292         . "StrictNodes" changes the behavior of ExcludeNodes only. When
3293           StrictNodes is set, Tor should avoid all nodes listed in
3294           ExcludeNodes, even when it will make user requests fail. When
3295           StrictNodes is *not* set, then Tor should follow ExcludeNodes
3296           whenever it can, except when it must use an excluded node to
3297           perform self-tests, connect to a hidden service, provide a
3298           hidden service, fulfill a .exit request, upload directory
3299           information, or fetch directory information.
3300       Collectively, the changes to implement the behavior fix bug 1090.
3301     - ExcludeNodes now takes precedence over EntryNodes and ExitNodes: if
3302       a node is listed in both, it's treated as excluded.
3303     - ExcludeNodes now applies to directory nodes -- as a preference if
3304       StrictNodes is 0, or an absolute requirement if StrictNodes is 1.
3305       Don't exclude all the directory authorities and set StrictNodes to 1
3306       unless you really want your Tor to break.
3307     - ExcludeNodes and ExcludeExitNodes now override exit enclaving.
3308     - ExcludeExitNodes now overrides .exit requests.
3309     - We don't use bridges listed in ExcludeNodes.
3310     - When StrictNodes is 1:
3311        . We now apply ExcludeNodes to hidden service introduction points
3312          and to rendezvous points selected by hidden service users. This
3313          can make your hidden service less reliable: use it with caution!
3314        . If we have used ExcludeNodes on ourself, do not try relay
3315          reachability self-tests.
3316        . If we have excluded all the directory authorities, we will not
3317          even try to upload our descriptor if we're a relay.
3318        . Do not honor .exit requests to an excluded node.
3319     - Remove a misfeature that caused us to ignore the Fast/Stable flags
3320       when ExitNodes is set. Bugfix on 0.2.2.7-alpha.
3321     - When the set of permitted nodes changes, we now remove any mappings
3322       introduced via TrackExitHosts to now-excluded nodes. Bugfix on
3323       0.1.0.1-rc.
3324     - We never cannibalize a circuit that had excluded nodes on it, even
3325       if StrictNodes is 0. Bugfix on 0.1.0.1-rc.
3326     - Revert a change where we would be laxer about attaching streams to
3327       circuits than when building the circuits. This was meant to prevent
3328       a set of bugs where streams were never attachable, but our improved
3329       code here should make this unnecessary. Bugfix on 0.2.2.7-alpha.
3330     - Keep track of how many times we launch a new circuit to handle a
3331       given stream. Too many launches could indicate an inconsistency
3332       between our "launch a circuit to handle this stream" logic and our
3333       "attach this stream to one of the available circuits" logic.
3334     - Improve log messages related to excluded nodes.
3335
3336   o Minor bugfixes:
3337     - Fix a spurious warning when moving from a short month to a long
3338       month on relays with month-based BandwidthAccounting. Bugfix on
3339       0.2.2.17-alpha; fixes bug 3020.
3340     - When a client finds that an origin circuit has run out of 16-bit
3341       stream IDs, we now mark it as unusable for new streams. Previously,
3342       we would try to close the entire circuit. Bugfix on 0.0.6.
3343     - Add a forgotten cast that caused a compile warning on OS X 10.6.
3344       Bugfix on 0.2.2.24-alpha.
3345     - Be more careful about reporting the correct error from a failed
3346       connect() system call. Under some circumstances, it was possible to
3347       look at an incorrect value for errno when sending the end reason.
3348       Bugfix on 0.1.0.1-rc.
3349     - Correctly handle an "impossible" overflow cases in connection byte
3350       counting, where we write or read more than 4GB on an edge connection
3351       in a single second. Bugfix on 0.1.2.8-beta.
3352     - Correct the warning displayed when a rendezvous descriptor exceeds
3353       the maximum size. Fixes bug 2750; bugfix on 0.2.1.5-alpha. Found by
3354       John Brooks.
3355     - Clients and hidden services now use HSDir-flagged relays for hidden
3356       service descriptor downloads and uploads even if the relays have no
3357       DirPort set and the client has disabled TunnelDirConns. This will
3358       eventually allow us to give the HSDir flag to relays with no
3359       DirPort. Fixes bug 2722; bugfix on 0.2.1.6-alpha.
3360     - Downgrade "no current certificates known for authority" message from
3361       Notice to Info. Fixes bug 2899; bugfix on 0.2.0.10-alpha.
3362     - Make the SIGNAL DUMP control-port command work on FreeBSD. Fixes bug
3363       2917. Bugfix on 0.1.1.1-alpha.
3364     - Only limit the lengths of single HS descriptors, even when multiple
3365       HS descriptors are published to an HSDir relay in a single POST
3366       operation. Fixes bug 2948; bugfix on 0.2.1.5-alpha. Found by hsdir.
3367     - Write the current time into the LastWritten line in our state file,
3368       rather than the time from the previous write attempt. Also, stop
3369       trying to use a time of -1 in our log statements. Fixes bug 3039;
3370       bugfix on 0.2.2.14-alpha.
3371     - Be more consistent in our treatment of file system paths. "~" should
3372       get expanded to the user's home directory in the Log config option.
3373       Fixes bug 2971; bugfix on 0.2.0.1-alpha, which introduced the
3374       feature for the -f and --DataDirectory options.
3375
3376   o Minor features:
3377     - Make sure every relay writes a state file at least every 12 hours.
3378       Previously, a relay could go for weeks without writing its state
3379       file, and on a crash could lose its bandwidth history, capacity
3380       estimates, client country statistics, and so on. Addresses bug 3012.
3381     - Send END_STREAM_REASON_NOROUTE in response to EHOSTUNREACH errors.
3382       Clients before 0.2.1.27 didn't handle NOROUTE correctly, but such
3383       clients are already deprecated because of security bugs.
3384     - Don't allow v0 hidden service authorities to act as clients.
3385       Required by fix for bug 3000.
3386     - Ignore SIGNAL NEWNYM commands on relay-only Tor instances. Required
3387       by fix for bug 3000.
3388     - Ensure that no empty [dirreq-](read|write)-history lines are added
3389       to an extrainfo document. Implements ticket 2497.
3390
3391   o Code simplification and refactoring:
3392     - Remove workaround code to handle directory responses from servers
3393       that had bug 539 (they would send HTTP status 503 responses _and_
3394       send a body too). Since only server versions before
3395       0.2.0.16-alpha/0.1.2.19 were affected, there is no longer reason to
3396       keep the workaround in place.
3397     - Remove the old 'fuzzy time' logic. It was supposed to be used for
3398       handling calculations where we have a known amount of clock skew and
3399       an allowed amount of unknown skew. But we only used it in three
3400       places, and we never adjusted the known/unknown skew values. This is
3401       still something we might want to do someday, but if we do, we'll
3402       want to do it differently.
3403     - Avoid signed/unsigned comparisons by making SIZE_T_CEILING unsigned.
3404       None of the cases where we did this before were wrong, but by making
3405       this change we avoid warnings. Fixes bug 2475; bugfix on 0.2.1.28.
3406     - Use GetTempDir to find the proper temporary directory location on
3407       Windows when generating temporary files for the unit tests. Patch by
3408       Gisle Vanem.
3409
3410
3411 Changes in version 0.2.2.24-alpha - 2011-04-08
3412   Tor 0.2.2.24-alpha fixes a variety of bugs, including a big bug that
3413   prevented Tor clients from effectively using "multihomed" bridges,
3414   that is, bridges that listen on multiple ports or IP addresses so users
3415   can continue to use some of their addresses even if others get blocked.
3416
3417   o Major bugfixes:
3418     - Fix a bug where bridge users who configure the non-canonical
3419       address of a bridge automatically switch to its canonical
3420       address. If a bridge listens at more than one address, it should be
3421       able to advertise those addresses independently and any non-blocked
3422       addresses should continue to work. Bugfix on Tor 0.2.0.x. Fixes
3423       bug 2510.
3424     - If you configured Tor to use bridge A, and then quit and
3425       configured Tor to use bridge B instead, it would happily continue
3426       to use bridge A if it's still reachable. While this behavior is
3427       a feature if your goal is connectivity, in some scenarios it's a
3428       dangerous bug. Bugfix on Tor 0.2.0.1-alpha; fixes bug 2511.
3429     - Directory authorities now use data collected from their own
3430       uptime observations when choosing whether to assign the HSDir flag
3431       to relays, instead of trusting the uptime value the relay reports in
3432       its descriptor. This change helps prevent an attack where a small
3433       set of nodes with frequently-changing identity keys can blackhole
3434       a hidden service. (Only authorities need upgrade; others will be
3435       fine once they do.) Bugfix on 0.2.0.10-alpha; fixes bug 2709.
3436
3437   o Minor bugfixes:
3438     - When we restart our relay, we might get a successful connection
3439       from the outside before we've started our reachability tests,
3440       triggering a warning: "ORPort found reachable, but I have no
3441       routerinfo yet. Failing to inform controller of success." This
3442       bug was harmless unless Tor is running under a controller
3443       like Vidalia, in which case the controller would never get a
3444       REACHABILITY_SUCCEEDED status event. Bugfix on 0.1.2.6-alpha;
3445       fixes bug 1172.
3446     - Make directory authorities more accurate at recording when
3447       relays that have failed several reachability tests became
3448       unreachable, so we can provide more accuracy at assigning Stable,
3449       Guard, HSDir, etc flags. Bugfix on 0.2.0.6-alpha. Resolves bug 2716.
3450     - Fix an issue that prevented static linking of libevent on
3451       some platforms (notably Linux). Fixes bug 2698; bugfix on
3452       versions 0.2.1.23/0.2.2.8-alpha (the versions introducing
3453       the --with-static-libevent configure option).
3454     - We now ask the other side of a stream (the client or the exit)
3455       for more data on that stream when the amount of queued data on
3456       that stream dips low enough. Previously, we wouldn't ask the
3457       other side for more data until either it sent us more data (which
3458       it wasn't supposed to do if it had exhausted its window!) or we
3459       had completely flushed all our queued data. This flow control fix
3460       should improve throughput. Fixes bug 2756; bugfix on the earliest
3461       released versions of Tor (svn commit r152).
3462     - Avoid a double-mark-for-free warning when failing to attach a
3463       transparent proxy connection. (We thought we had fixed this in
3464       0.2.2.23-alpha, but it turns out our fix was checking the wrong
3465       connection.) Fixes bug 2757; bugfix on 0.1.2.1-alpha (the original
3466       bug) and 0.2.2.23-alpha (the incorrect fix).
3467     - When warning about missing zlib development packages during compile,
3468       give the correct package names. Bugfix on 0.2.0.1-alpha.
3469
3470   o Minor features:
3471     - Directory authorities now log the source of a rejected POSTed v3
3472       networkstatus vote.
3473     - Make compilation with clang possible when using
3474       --enable-gcc-warnings by removing two warning options that clang
3475       hasn't implemented yet and by fixing a few warnings. Implements
3476       ticket 2696.
3477     - When expiring circuits, use microsecond timers rather than
3478       one-second timers. This can avoid an unpleasant situation where a
3479       circuit is launched near the end of one second and expired right
3480       near the beginning of the next, and prevent fluctuations in circuit
3481       timeout values.
3482     - Use computed circuit-build timeouts to decide when to launch
3483       parallel introduction circuits for hidden services. (Previously,
3484       we would retry after 15 seconds.)
3485     - Update to the April 1 2011 Maxmind GeoLite Country database.
3486
3487   o Packaging fixes:
3488     - Create the /var/run/tor directory on startup on OpenSUSE if it is
3489       not already created. Patch from Andreas Stieger. Fixes bug 2573.
3490
3491   o Documentation changes:
3492     - Modernize the doxygen configuration file slightly. Fixes bug 2707.
3493     - Resolve all doxygen warnings except those for missing documentation.
3494       Fixes bug 2705.
3495     - Add doxygen documentation for more functions, fields, and types.
3496
3497
3498 Changes in version 0.2.2.23-alpha - 2011-03-08
3499   Tor 0.2.2.23-alpha lets relays record their bandwidth history so when
3500   they restart they don't lose their bandwidth capacity estimate. This
3501   release also fixes a diverse set of user-facing bugs, ranging from
3502   relays overrunning their rate limiting to clients falsely warning about
3503   clock skew to bridge descriptor leaks by our bridge directory authority.
3504
3505   o Major bugfixes:
3506     - Stop sending a CLOCK_SKEW controller status event whenever
3507       we fetch directory information from a relay that has a wrong clock.
3508       Instead, only inform the controller when it's a trusted authority
3509       that claims our clock is wrong. Bugfix on 0.1.2.6-alpha; fixes
3510       the rest of bug 1074.
3511     - Fix an assert in parsing router descriptors containing IPv6
3512       addresses. This one took down the directory authorities when
3513       somebody tried some experimental code. Bugfix on 0.2.1.3-alpha.
3514     - Make the bridge directory authority refuse to answer directory
3515       requests for "all" descriptors. It used to include bridge
3516       descriptors in its answer, which was a major information leak.
3517       Found by "piebeer". Bugfix on 0.2.0.3-alpha.
3518     - If relays set RelayBandwidthBurst but not RelayBandwidthRate,
3519       Tor would ignore their RelayBandwidthBurst setting,
3520       potentially using more bandwidth than expected. Bugfix on
3521       0.2.0.1-alpha. Reported by Paul Wouters. Fixes bug 2470.
3522     - Ignore and warn if the user mistakenly sets "PublishServerDescriptor
3523       hidserv" in her torrc. The 'hidserv' argument never controlled
3524       publication of hidden service descriptors. Bugfix on 0.2.0.1-alpha.
3525
3526   o Major features:
3527     - Relays now save observed peak bandwidth throughput rates to their
3528       state file (along with total usage, which was already saved)
3529       so that they can determine their correct estimated bandwidth on
3530       restart. Resolves bug 1863, where Tor relays would reset their
3531       estimated bandwidth to 0 after restarting.
3532     - Directory authorities now take changes in router IP address and
3533       ORPort into account when determining router stability. Previously,
3534       if a router changed its IP or ORPort, the authorities would not
3535       treat it as having any downtime for the purposes of stability
3536       calculation, whereas clients would experience downtime since the
3537       change could take a while to propagate to them. Resolves issue 1035.
3538     - Enable Address Space Layout Randomization (ASLR) and Data Execution
3539       Prevention (DEP) by default on Windows to make it harder for
3540       attackers to exploit vulnerabilities. Patch from John Brooks.
3541
3542   o Minor bugfixes (on 0.2.1.x and earlier):
3543     - Fix a rare crash bug that could occur when a client was configured
3544       with a large number of bridges. Fixes bug 2629; bugfix on
3545       0.2.1.2-alpha. Bugfix by trac user "shitlei".
3546     - Avoid a double mark-for-free warning when failing to attach a
3547       transparent proxy connection. Bugfix on 0.1.2.1-alpha. Fixes
3548       bug 2279.
3549     - Correctly detect failure to allocate an OpenSSL BIO. Fixes bug 2378;
3550       found by "cypherpunks". This bug was introduced before the first
3551       Tor release, in svn commit r110.
3552     - Country codes aren't supported in EntryNodes until 0.2.3.x, so
3553       don't mention them in the manpage. Fixes bug 2450; issue
3554       spotted by keb and G-Lo.
3555     - Fix a bug in bandwidth history state parsing that could have been
3556       triggered if a future version of Tor ever changed the timing
3557       granularity at which bandwidth history is measured. Bugfix on
3558       Tor 0.1.1.11-alpha.
3559     - When a relay decides that its DNS is too broken for it to serve
3560       as an exit server, it advertised itself as a non-exit, but
3561       continued to act as an exit. This could create accidental
3562       partitioning opportunities for users. Instead, if a relay is
3563       going to advertise reject *:* as its exit policy, it should
3564       really act with exit policy "reject *:*". Fixes bug 2366.
3565       Bugfix on Tor 0.1.2.5-alpha. Bugfix by user "postman" on trac.
3566     - In the special case where you configure a public exit relay as your
3567       bridge, Tor would be willing to use that exit relay as the last
3568       hop in your circuit as well. Now we fail that circuit instead.
3569       Bugfix on 0.2.0.12-alpha. Fixes bug 2403. Reported by "piebeer".
3570     - Fix a bug with our locking implementation on Windows that couldn't
3571       correctly detect when a file was already locked. Fixes bug 2504,
3572       bugfix on 0.2.1.6-alpha.
3573     - Fix IPv6-related connect() failures on some platforms (BSD, OS X).
3574       Bugfix on 0.2.0.3-alpha; fixes first part of bug 2660. Patch by
3575       "piebeer".
3576     - Set target port in get_interface_address6() correctly. Bugfix
3577       on 0.1.1.4-alpha and 0.2.0.3-alpha; fixes second part of bug 2660.
3578     - Directory authorities are now more robust to hops back in time
3579       when calculating router stability. Previously, if a run of uptime
3580       or downtime appeared to be negative, the calculation could give
3581       incorrect results. Bugfix on 0.2.0.6-alpha; noticed when fixing
3582       bug 1035.
3583     - Fix an assert that got triggered when using the TestingTorNetwork
3584       configuration option and then issuing a GETINFO config-text control
3585       command. Fixes bug 2250; bugfix on 0.2.1.2-alpha.
3586
3587   o Minor bugfixes (on 0.2.2.x):
3588     - Clients should not weight BadExit nodes as Exits in their node
3589       selection. Similarly, directory authorities should not count BadExit
3590       bandwidth as Exit bandwidth when computing bandwidth-weights.
3591       Bugfix on 0.2.2.10-alpha; fixes bug 2203.
3592     - Correctly clear our dir_read/dir_write history when there is an
3593       error parsing any bw history value from the state file. Bugfix on
3594       Tor 0.2.2.15-alpha.
3595     - Resolve a bug in verifying signatures of directory objects
3596       with digests longer than SHA1. Bugfix on 0.2.2.20-alpha.
3597       Fixes bug 2409. Found by "piebeer".
3598     - Bridge authorities no longer crash on SIGHUP when they try to
3599       publish their relay descriptor to themselves. Fixes bug 2572. Bugfix
3600       on 0.2.2.22-alpha.
3601
3602   o Minor features:
3603     - Log less aggressively about circuit timeout changes, and improve
3604       some other circuit timeout messages. Resolves bug 2004.
3605     - Log a little more clearly about the times at which we're no longer
3606       accepting new connections. Resolves bug 2181.
3607     - Reject attempts at the client side to open connections to private
3608       IP addresses (like 127.0.0.1, 10.0.0.1, and so on) with
3609       a randomly chosen exit node. Attempts to do so are always
3610       ill-defined, generally prevented by exit policies, and usually
3611       in error. This will also help to detect loops in transparent
3612       proxy configurations. You can disable this feature by setting
3613       "ClientRejectInternalAddresses 0" in your torrc.
3614     - Always treat failure to allocate an RSA key as an unrecoverable
3615       allocation error.
3616     - Update to the March 1 2011 Maxmind GeoLite Country database.
3617
3618   o Minor features (log subsystem):
3619     - Add documentation for configuring logging at different severities in
3620       different log domains. We've had this feature since 0.2.1.1-alpha,
3621       but for some reason it never made it into the manpage. Fixes
3622       bug 2215.
3623     - Make it simpler to specify "All log domains except for A and B".
3624       Previously you needed to say "[*,~A,~B]". Now you can just say
3625       "[~A,~B]".
3626     - Add a "LogMessageDomains 1" option to include the domains of log
3627       messages along with the messages. Without this, there's no way
3628       to use log domains without reading the source or doing a lot
3629       of guessing.
3630
3631   o Packaging changes:
3632     - Stop shipping the Tor specs files and development proposal documents
3633       in the tarball. They are now in a separate git repository at
3634       git://git.torproject.org/torspec.git
3635
3636
3637 Changes in version 0.2.1.30 - 2011-02-23
3638   Tor 0.2.1.30 fixes a variety of less critical bugs. The main other
3639   change is a slight tweak to Tor's TLS handshake that makes relays
3640   and bridges that run this new version reachable from Iran again.
3641   We don't expect this tweak will win the arms race long-term, but it
3642   buys us time until we roll out a better solution.
3643
3644   o Major bugfixes:
3645     - Stop sending a CLOCK_SKEW controller status event whenever
3646       we fetch directory information from a relay that has a wrong clock.
3647       Instead, only inform the controller when it's a trusted authority
3648       that claims our clock is wrong. Bugfix on 0.1.2.6-alpha; fixes
3649       the rest of bug 1074.
3650     - Fix a bounds-checking error that could allow an attacker to
3651       remotely crash a directory authority. Bugfix on 0.2.1.5-alpha.
3652       Found by "piebeer".
3653     - If relays set RelayBandwidthBurst but not RelayBandwidthRate,
3654       Tor would ignore their RelayBandwidthBurst setting,
3655       potentially using more bandwidth than expected. Bugfix on
3656       0.2.0.1-alpha. Reported by Paul Wouters. Fixes bug 2470.
3657     - Ignore and warn if the user mistakenly sets "PublishServerDescriptor
3658       hidserv" in her torrc. The 'hidserv' argument never controlled
3659       publication of hidden service descriptors. Bugfix on 0.2.0.1-alpha.
3660
3661   o Minor features:
3662     - Adjust our TLS Diffie-Hellman parameters to match those used by
3663       Apache's mod_ssl.
3664     - Update to the February 1 2011 Maxmind GeoLite Country database.
3665
3666   o Minor bugfixes:
3667     - Check for and reject overly long directory certificates and
3668       directory tokens before they have a chance to hit any assertions.
3669       Bugfix on 0.2.1.28. Found by "doorss".
3670     - Bring the logic that gathers routerinfos and assesses the
3671       acceptability of circuits into line. This prevents a Tor OP from
3672       getting locked in a cycle of choosing its local OR as an exit for a
3673       path (due to a .exit request) and then rejecting the circuit because
3674       its OR is not listed yet. It also prevents Tor clients from using an
3675       OR running in the same instance as an exit (due to a .exit request)
3676       if the OR does not meet the same requirements expected of an OR
3677       running elsewhere. Fixes bug 1859; bugfix on 0.1.0.1-rc.
3678
3679   o Packaging changes:
3680     - Stop shipping the Tor specs files and development proposal documents
3681       in the tarball. They are now in a separate git repository at
3682       git://git.torproject.org/torspec.git
3683     - Do not include Git version tags as though they are SVN tags when
3684       generating a tarball from inside a repository that has switched
3685       between branches. Bugfix on 0.2.1.15-rc; fixes bug 2402.
3686
3687
3688 Changes in version 0.2.2.22-alpha - 2011-01-25
3689   Tor 0.2.2.22-alpha fixes a few more less-critical security issues. The
3690   main other change is a slight tweak to Tor's TLS handshake that makes
3691   relays and bridges that run this new version reachable from Iran again.
3692   We don't expect this tweak will win the arms race long-term, but it
3693   will buy us a bit more time until we roll out a better solution.
3694
3695   o Major bugfixes:
3696     - Fix a bounds-checking error that could allow an attacker to
3697       remotely crash a directory authority. Bugfix on 0.2.1.5-alpha.
3698       Found by "piebeer".
3699     - Don't assert when changing from bridge to relay or vice versa
3700       via the controller. The assert happened because we didn't properly
3701       initialize our keys in this case. Bugfix on 0.2.2.18-alpha; fixes
3702       bug 2433. Reported by bastik.
3703
3704   o Minor features:
3705     - Adjust our TLS Diffie-Hellman parameters to match those used by
3706       Apache's mod_ssl.
3707     - Provide a log message stating which geoip file we're parsing
3708       instead of just stating that we're parsing the geoip file.
3709       Implements ticket 2432.
3710
3711   o Minor bugfixes:
3712     - Check for and reject overly long directory certificates and
3713       directory tokens before they have a chance to hit any assertions.
3714       Bugfix on 0.2.1.28 / 0.2.2.20-alpha. Found by "doorss".
3715
3716
3717 Changes in version 0.2.2.21-alpha - 2011-01-15
3718   Tor 0.2.2.21-alpha includes all the patches from Tor 0.2.1.29, which
3719   continues our recent code security audit work. The main fix resolves
3720   a remote heap overflow vulnerability that can allow remote code
3721   execution (CVE-2011-0427). Other fixes address a variety of assert
3722   and crash bugs, most of which we think are hard to exploit remotely.
3723
3724   o Major bugfixes (security), also included in 0.2.1.29:
3725     - Fix a heap overflow bug where an adversary could cause heap
3726       corruption. This bug probably allows remote code execution
3727       attacks. Reported by "debuger". Fixes CVE-2011-0427. Bugfix on
3728       0.1.2.10-rc.
3729     - Prevent a denial-of-service attack by disallowing any
3730       zlib-compressed data whose compression factor is implausibly
3731       high. Fixes part of bug 2324; reported by "doorss".
3732     - Zero out a few more keys in memory before freeing them. Fixes
3733       bug 2384 and part of bug 2385. These key instances found by
3734       "cypherpunks", based on Andrew Case's report about being able
3735       to find sensitive data in Tor's memory space if you have enough
3736       permissions. Bugfix on 0.0.2pre9.
3737
3738   o Major bugfixes (crashes), also included in 0.2.1.29:
3739     - Prevent calls to Libevent from inside Libevent log handlers.
3740       This had potential to cause a nasty set of crashes, especially
3741       if running Libevent with debug logging enabled, and running
3742       Tor with a controller watching for low-severity log messages.
3743       Bugfix on 0.1.0.2-rc. Fixes bug 2190.
3744     - Add a check for SIZE_T_MAX to tor_realloc() to try to avoid
3745       underflow errors there too. Fixes the other part of bug 2324.
3746     - Fix a bug where we would assert if we ever had a
3747       cached-descriptors.new file (or another file read directly into
3748       memory) of exactly SIZE_T_CEILING bytes. Fixes bug 2326; bugfix
3749       on 0.2.1.25. Found by doorss.
3750     - Fix some potential asserts and parsing issues with grossly
3751       malformed router caches. Fixes bug 2352; bugfix on Tor 0.2.1.27.
3752       Found by doorss.
3753
3754   o Minor bugfixes (other), also included in 0.2.1.29:
3755     - Fix a bug with handling misformed replies to reverse DNS lookup
3756       requests in DNSPort. Bugfix on Tor 0.2.0.1-alpha. Related to a
3757       bug reported by doorss.
3758     - Fix compilation on mingw when a pthreads compatibility library
3759       has been installed. (We don't want to use it, so we shouldn't
3760       be including pthread.h.) Fixes bug 2313; bugfix on 0.1.0.1-rc.
3761     - Fix a bug where we would declare that we had run out of virtual
3762       addresses when the address space was only half-exhausted. Bugfix
3763       on 0.1.2.1-alpha.
3764     - Correctly handle the case where AutomapHostsOnResolve is set but
3765       no virtual addresses are available. Fixes bug 2328; bugfix on
3766       0.1.2.1-alpha. Bug found by doorss.
3767     - Correctly handle wrapping around when we run out of virtual
3768       address space. Found by cypherpunks; bugfix on 0.2.0.5-alpha.
3769
3770   o Minor features, also included in 0.2.1.29:
3771     - Update to the January 1 2011 Maxmind GeoLite Country database.
3772     - Introduce output size checks on all of our decryption functions.
3773
3774   o Build changes, also included in 0.2.1.29:
3775     - Tor does not build packages correctly with Automake 1.6 and earlier;
3776       added a check to Makefile.am to make sure that we're building with
3777       Automake 1.7 or later.
3778     - The 0.2.1.28 tarball was missing src/common/OpenBSD_malloc_Linux.c
3779       because we built it with a too-old version of automake. Thus that
3780       release broke ./configure --enable-openbsd-malloc, which is popular
3781       among really fast exit relays on Linux.
3782
3783   o Major bugfixes, new in 0.2.2.21-alpha:
3784     - Prevent crash/heap corruption when the cbtnummodes consensus
3785       parameter is set to 0 or large values. Fixes bug 2317; bugfix
3786       on 0.2.2.14-alpha.
3787
3788   o Major features, new in 0.2.2.21-alpha:
3789     - Introduce minimum/maximum values that clients will believe
3790       from the consensus. Now we'll have a better chance to avoid crashes
3791       or worse when a consensus param has a weird value.
3792
3793   o Minor features, new in 0.2.2.21-alpha:
3794     - Make sure to disable DirPort if running as a bridge. DirPorts aren't
3795       used on bridges, and it makes bridge scanning somewhat easier.
3796     - If writing the state file to disk fails, wait up to an hour before
3797       retrying again, rather than trying again each second. Fixes bug
3798       2346; bugfix on Tor 0.1.1.3-alpha.
3799     - Make Libevent log messages get delivered to controllers later,
3800       and not from inside the Libevent log handler. This prevents unsafe
3801       reentrant Libevent calls while still letting the log messages
3802       get through.
3803     - Detect platforms that brokenly use a signed size_t, and refuse to
3804       build there. Found and analyzed by doorss and rransom.
3805     - Fix a bunch of compile warnings revealed by mingw with gcc 4.5.
3806       Resolves bug 2314.
3807
3808   o Minor bugfixes, new in 0.2.2.21-alpha:
3809     - Handle SOCKS messages longer than 128 bytes long correctly, rather
3810       than waiting forever for them to finish. Fixes bug 2330; bugfix
3811       on 0.2.0.16-alpha. Found by doorss.
3812     - Add assertions to check for overflow in arguments to
3813       base32_encode() and base32_decode(); fix a signed-unsigned
3814       comparison there too. These bugs are not actually reachable in Tor,
3815       but it's good to prevent future errors too. Found by doorss.
3816     - Correctly detect failures to create DNS requests when using Libevent
3817       versions before v2. (Before Libevent 2, we used our own evdns
3818       implementation. Its return values for Libevent's evdns_resolve_*()
3819       functions are not consistent with those from Libevent.) Fixes bug
3820       2363; bugfix on 0.2.2.6-alpha. Found by "lodger".
3821
3822   o Documentation, new in 0.2.2.21-alpha:
3823     - Document the default socks host and port (127.0.0.1:9050) for
3824       tor-resolve.
3825
3826
3827 Changes in version 0.2.1.29 - 2011-01-15
3828   Tor 0.2.1.29 continues our recent code security audit work. The main
3829   fix resolves a remote heap overflow vulnerability that can allow remote
3830   code execution. Other fixes address a variety of assert and crash bugs,
3831   most of which we think are hard to exploit remotely.
3832
3833   o Major bugfixes (security):
3834     - Fix a heap overflow bug where an adversary could cause heap
3835       corruption. This bug probably allows remote code execution
3836       attacks. Reported by "debuger". Fixes CVE-2011-0427. Bugfix on
3837       0.1.2.10-rc.
3838     - Prevent a denial-of-service attack by disallowing any
3839       zlib-compressed data whose compression factor is implausibly
3840       high. Fixes part of bug 2324; reported by "doorss".
3841     - Zero out a few more keys in memory before freeing them. Fixes
3842       bug 2384 and part of bug 2385. These key instances found by
3843       "cypherpunks", based on Andrew Case's report about being able
3844       to find sensitive data in Tor's memory space if you have enough
3845       permissions. Bugfix on 0.0.2pre9.
3846
3847   o Major bugfixes (crashes):
3848     - Prevent calls to Libevent from inside Libevent log handlers.
3849       This had potential to cause a nasty set of crashes, especially
3850       if running Libevent with debug logging enabled, and running
3851       Tor with a controller watching for low-severity log messages.
3852       Bugfix on 0.1.0.2-rc. Fixes bug 2190.
3853     - Add a check for SIZE_T_MAX to tor_realloc() to try to avoid
3854       underflow errors there too. Fixes the other part of bug 2324.
3855     - Fix a bug where we would assert if we ever had a
3856       cached-descriptors.new file (or another file read directly into
3857       memory) of exactly SIZE_T_CEILING bytes. Fixes bug 2326; bugfix
3858       on 0.2.1.25. Found by doorss.
3859     - Fix some potential asserts and parsing issues with grossly
3860       malformed router caches. Fixes bug 2352; bugfix on Tor 0.2.1.27.
3861       Found by doorss.
3862
3863   o Minor bugfixes (other):
3864     - Fix a bug with handling misformed replies to reverse DNS lookup
3865       requests in DNSPort. Bugfix on Tor 0.2.0.1-alpha. Related to a
3866       bug reported by doorss.
3867     - Fix compilation on mingw when a pthreads compatibility library
3868       has been installed. (We don't want to use it, so we shouldn't
3869       be including pthread.h.) Fixes bug 2313; bugfix on 0.1.0.1-rc.
3870     - Fix a bug where we would declare that we had run out of virtual
3871       addresses when the address space was only half-exhausted. Bugfix
3872       on 0.1.2.1-alpha.
3873     - Correctly handle the case where AutomapHostsOnResolve is set but
3874       no virtual addresses are available. Fixes bug 2328; bugfix on
3875       0.1.2.1-alpha. Bug found by doorss.
3876     - Correctly handle wrapping around to when we run out of virtual
3877       address space. Found by cypherpunks, bugfix on 0.2.0.5-alpha.
3878     - The 0.2.1.28 tarball was missing src/common/OpenBSD_malloc_Linux.c
3879       because we built it with a too-old version of automake. Thus that
3880       release broke ./configure --enable-openbsd-malloc, which is popular
3881       among really fast exit relays on Linux.
3882
3883   o Minor features:
3884     - Update to the January 1 2011 Maxmind GeoLite Country database.
3885     - Introduce output size checks on all of our decryption functions.
3886
3887   o Build changes:
3888     - Tor does not build packages correctly with Automake 1.6 and earlier;
3889       added a check to Makefile.am to make sure that we're building with
3890       Automake 1.7 or later.
3891
3892
3893 Changes in version 0.2.2.20-alpha - 2010-12-17
3894   Tor 0.2.2.20-alpha does some code cleanup to reduce the risk of remotely
3895   exploitable bugs. We also fix a variety of other significant bugs,
3896   change the IP address for one of our directory authorities, and update
3897   the minimum version that Tor relays must run to join the network.
3898
3899   o Major bugfixes:
3900     - Fix a remotely exploitable bug that could be used to crash instances
3901       of Tor remotely by overflowing on the heap. Remote-code execution
3902       hasn't been confirmed, but can't be ruled out. Everyone should
3903       upgrade. Bugfix on the 0.1.1 series and later.
3904     - Fix a bug that could break accounting on 64-bit systems with large
3905       time_t values, making them hibernate for impossibly long intervals.
3906       Fixes bug 2146. Bugfix on 0.0.9pre6; fix by boboper.
3907     - Fix a logic error in directory_fetches_from_authorities() that
3908       would cause all _non_-exits refusing single-hop-like circuits
3909       to fetch from authorities, when we wanted to have _exits_ fetch
3910       from authorities. Fixes more of 2097. Bugfix on 0.2.2.16-alpha;
3911       fix by boboper.
3912     - Fix a stream fairness bug that would cause newer streams on a given
3913       circuit to get preference when reading bytes from the origin or
3914       destination. Fixes bug 2210. Fix by Mashael AlSabah. This bug was
3915       introduced before the first Tor release, in svn revision r152.
3916
3917   o Directory authority changes:
3918     - Change IP address and ports for gabelmoo (v3 directory authority).
3919
3920   o Minor bugfixes:
3921     - Avoid crashes when AccountingMax is set on clients. Fixes bug 2235.
3922       Bugfix on 0.2.2.18-alpha. Diagnosed by boboper.
3923     - Fix an off-by-one error in calculating some controller command
3924       argument lengths. Fortunately, this mistake is harmless since
3925       the controller code does redundant NUL termination too. Found by
3926       boboper. Bugfix on 0.1.1.1-alpha.
3927     - Do not dereference NULL if a bridge fails to build its
3928       extra-info descriptor. Found by an anonymous commenter on
3929       Trac. Bugfix on 0.2.2.19-alpha.
3930
3931   o Minor features:
3932     - Update to the December 1 2010 Maxmind GeoLite Country database.
3933     - Directory authorities now reject relays running any versions of
3934       Tor between 0.2.1.3-alpha and 0.2.1.18 inclusive; they have
3935       known bugs that keep RELAY_EARLY cells from working on rendezvous
3936       circuits. Followup to fix for bug 2081.
3937     - Directory authorities now reject relays running any version of Tor
3938       older than 0.2.0.26-rc. That version is the earliest that fetches
3939       current directory information correctly. Fixes bug 2156.
3940     - Report only the top 10 ports in exit-port stats in order not to
3941       exceed the maximum extra-info descriptor length of 50 KB. Implements
3942       task 2196.
3943
3944
3945 Changes in version 0.2.1.28 - 2010-12-17
3946   Tor 0.2.1.28 does some code cleanup to reduce the risk of remotely
3947   exploitable bugs. We also took this opportunity to change the IP address
3948   for one of our directory authorities, and to update the geoip database
3949   we ship.
3950
3951   o Major bugfixes:
3952     - Fix a remotely exploitable bug that could be used to crash instances
3953       of Tor remotely by overflowing on the heap. Remote-code execution
3954       hasn't been confirmed, but can't be ruled out. Everyone should
3955       upgrade. Bugfix on the 0.1.1 series and later.
3956
3957   o Directory authority changes:
3958     - Change IP address and ports for gabelmoo (v3 directory authority).
3959
3960   o Minor features:
3961     - Update to the December 1 2010 Maxmind GeoLite Country database.
3962
3963
3964 Changes in version 0.2.1.27 - 2010-11-23
3965   Yet another OpenSSL security patch broke its compatibility with Tor:
3966   Tor 0.2.1.27 makes relays work with openssl 0.9.8p and 1.0.0.b. We
3967   also took this opportunity to fix several crash bugs, integrate a new
3968   directory authority, and update the bundled GeoIP database.
3969
3970   o Major bugfixes:
3971     - Resolve an incompatibility with OpenSSL 0.9.8p and OpenSSL 1.0.0b:
3972       No longer set the tlsext_host_name extension on server SSL objects;
3973       but continue to set it on client SSL objects. Our goal in setting
3974       it was to imitate a browser, not a vhosting server. Fixes bug 2204;
3975       bugfix on 0.2.1.1-alpha.
3976     - Do not log messages to the controller while shrinking buffer
3977       freelists. Doing so would sometimes make the controller connection
3978       try to allocate a buffer chunk, which would mess up the internals
3979       of the freelist and cause an assertion failure. Fixes bug 1125;
3980       fixed by Robert Ransom. Bugfix on 0.2.0.16-alpha.
3981     - Learn our external IP address when we're a relay or bridge, even if
3982       we set PublishServerDescriptor to 0. Bugfix on 0.2.0.3-alpha,
3983       where we introduced bridge relays that don't need to publish to
3984       be useful. Fixes bug 2050.
3985     - Do even more to reject (and not just ignore) annotations on
3986       router descriptors received anywhere but from the cache. Previously
3987       we would ignore such annotations at first, but cache them to disk
3988       anyway. Bugfix on 0.2.0.8-alpha. Found by piebeer.
3989     - When you're using bridges and your network goes away and your
3990       bridges get marked as down, recover when you attempt a new socks
3991       connection (if the network is back), rather than waiting up to an
3992       hour to try fetching new descriptors for your bridges. Bugfix on
3993       0.2.0.3-alpha; fixes bug 1981.
3994
3995   o Major features:
3996     - Move to the November 2010 Maxmind GeoLite country db (rather
3997       than the June 2009 ip-to-country GeoIP db) for our statistics that
3998       count how many users relays are seeing from each country. Now we'll
3999       have more accurate data, especially for many African countries.
4000
4001   o New directory authorities:
4002     - Set up maatuska (run by Linus Nordberg) as the eighth v3 directory
4003       authority.
4004
4005   o Minor bugfixes:
4006     - Fix an assertion failure that could occur in directory caches or
4007       bridge users when using a very short voting interval on a testing
4008       network. Diagnosed by Robert Hogan. Fixes bug 1141; bugfix on
4009       0.2.0.8-alpha.
4010     - Enforce multiplicity rules when parsing annotations. Bugfix on
4011       0.2.0.8-alpha. Found by piebeer.
4012     - Allow handshaking OR connections to take a full KeepalivePeriod
4013       seconds to handshake. Previously, we would close them after
4014       IDLE_OR_CONN_TIMEOUT (180) seconds, the same timeout as if they
4015       were open. Bugfix on 0.2.1.26; fixes bug 1840. Thanks to mingw-san
4016       for analysis help.
4017     - When building with --enable-gcc-warnings on OpenBSD, disable
4018       warnings in system headers. This makes --enable-gcc-warnings
4019       pass on OpenBSD 4.8.
4020
4021   o Minor features:
4022     - Exit nodes didn't recognize EHOSTUNREACH as a plausible error code,
4023       and so sent back END_STREAM_REASON_MISC. Clients now recognize a new
4024       stream ending reason for this case: END_STREAM_REASON_NOROUTE.
4025       Servers can start sending this code when enough clients recognize
4026       it. Bugfix on 0.1.0.1-rc; fixes part of bug 1793.
4027     - Build correctly on mingw with more recent versions of OpenSSL 0.9.8.
4028       Patch from mingw-san.
4029
4030   o Removed files:
4031     - Remove the old debian/ directory from the main Tor distribution.
4032       The official Tor-for-debian git repository lives at the URL
4033       https://git.torproject.org/debian/tor.git
4034     - Stop shipping the old doc/website/ directory in the tarball. We
4035       changed the website format in late 2010, and what we shipped in
4036       0.2.1.26 really wasn't that useful anyway.
4037
4038
4039 Changes in version 0.2.2.19-alpha - 2010-11-22
4040   Yet another OpenSSL security patch broke its compatibility with Tor:
4041   Tor 0.2.2.19-alpha makes relays work with OpenSSL 0.9.8p and 1.0.0.b.
4042
4043   o Major bugfixes:
4044     - Resolve an incompatibility with OpenSSL 0.9.8p and OpenSSL 1.0.0b:
4045       No longer set the tlsext_host_name extension on server SSL objects;
4046       but continue to set it on client SSL objects. Our goal in setting
4047       it was to imitate a browser, not a vhosting server. Fixes bug 2204;
4048       bugfix on 0.2.1.1-alpha.
4049
4050   o Minor bugfixes:
4051     - Try harder not to exceed the maximum length of 50 KB when writing
4052       statistics to extra-info descriptors. This bug was triggered by very
4053       fast relays reporting exit-port, entry, and dirreq statistics.
4054       Reported by Olaf Selke. Bugfix on 0.2.2.1-alpha. Fixes bug 2183.
4055     - Publish a router descriptor even if generating an extra-info
4056       descriptor fails. Previously we would not publish a router
4057       descriptor without an extra-info descriptor; this can cause fast
4058       exit relays collecting exit-port statistics to drop from the