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