aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorteor <teor2345@gmail.com>2017-10-25 13:15:35 +1100
committerNick Mathewson <nickm@torproject.org>2017-12-04 11:42:56 -0500
commit4b2995dc1d374e7434e98a326de7734d3ed57ca2 (patch)
tree46be0b5a9d8d5c28aa981b2da3e3c738513f9758 /doc
parent67eeee0c713caccf8e2b4114e7ea22c083ec0cb3 (diff)
downloadtor-4b2995dc1d374e7434e98a326de7734d3ed57ca2.tar.gz
tor-4b2995dc1d374e7434e98a326de7734d3ed57ca2.zip
Document the effects of AuthDirHasIPv6Connectivity
Fixes #23870 on 0.2.4.1-alpha.
Diffstat (limited to 'doc')
-rw-r--r--doc/tor.1.txt26
1 files changed, 23 insertions, 3 deletions
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index ba2bc13dad..6fa4684080 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -2345,9 +2345,29 @@ on the public Tor network.
[[AuthDirHasIPv6Connectivity]] **AuthDirHasIPv6Connectivity** **0**|**1**::
Authoritative directories only. When set to 0, OR ports with an
- IPv6 address are being accepted without reachability testing.
- When set to 1, IPv6 OR ports are being tested just like IPv4 OR
- ports. (Default: 0)
+ IPv6 address are not included in the authority's votes. When set to 1,
+ IPv6 OR ports are tested for reachability like IPv4 OR ports. If the
+ reachability test succeeds, the authority votes for the IPv6 ORPort, and
+ votes Running for the relay. If the reachability test fails, the authority
+ does not vote for the IPv6 ORPort, and does not vote Running (Default: 0) +
++
+ The content of the consensus depends on the number of voting authorities
+ that set AuthDirHasIPv6Connectivity:
+
+ If no authorities set AuthDirHasIPv6Connectivity 1, there will be no
+ IPv6 ORPorts in the consensus.
+
+ If a minority of authorities set AuthDirHasIPv6Connectivity 1,
+ unreachable IPv6 ORPorts will be removed from the consensus. But the
+ majority of IPv4-only authorities will still vote the relay as Running.
+ Reachable IPv6 ORPort lines will be included in the consensus
+
+ If a majority of voting authorities set AuthDirHasIPv6Connectivity 1,
+ relays with unreachable IPv6 ORPorts will not be listed as Running.
+ Reachable IPv6 ORPort lines will be included in the consensus
+ (To ensure that any valid majority will vote relays with unreachable
+ IPv6 ORPorts not Running, 75% of authorities must set
+ AuthDirHasIPv6Connectivity 1.)
[[MinMeasuredBWsForAuthToIgnoreAdvertised]] **MinMeasuredBWsForAuthToIgnoreAdvertised** __N__::
A total value, in abstract bandwidth units, describing how much