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