summaryrefslogtreecommitdiff
path: root/doc/tor.1.txt
diff options
context:
space:
mode:
authorteor <teor@torproject.org>2019-04-10 16:12:56 +1000
committerteor <teor@torproject.org>2019-04-10 17:43:59 +1000
commit8cfab3b7c3ed626b8f17018a627634de9b4502af (patch)
treee75f5d7cbb51c8aee56e882ac4a713fea39d8954 /doc/tor.1.txt
parentffdca3dd14ceb0adacc290c3207391c9810b9fbe (diff)
downloadtor-8cfab3b7c3ed626b8f17018a627634de9b4502af.tar.gz
tor-8cfab3b7c3ed626b8f17018a627634de9b4502af.zip
doc: Improve the documentation for MapAddress .exit
Fixes bug 30109; bugfix on 0.1.0.1-rc.
Diffstat (limited to 'doc/tor.1.txt')
-rw-r--r--doc/tor.1.txt17
1 files changed, 14 insertions, 3 deletions
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index c2df7687fe..a80da23a03 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -1056,8 +1056,8 @@ The following options are useful only for clients (that is, if
[[StrictNodes]] **StrictNodes** **0**|**1**::
If StrictNodes is set to 1, Tor will treat solely the ExcludeNodes option
as a requirement to follow for all the circuits you generate, even if
- doing so will break functionality for you (StrictNodes applies to neither
- ExcludeExitNodes nor to ExitNodes, nor to MiddleNodes). If StrictNodes
+ doing so will break functionality for you (StrictNodes does not apply to
+ ExcludeExitNodes, ExitNodes, MiddleNodes, or MapAddress). If StrictNodes
is set to 0, Tor will still try to avoid nodes in the ExcludeNodes list,
but it will err on the side of avoiding unexpected errors.
Specifically, StrictNodes 0 tells Tor that it is okay to use an excluded
@@ -1153,7 +1153,9 @@ The following options are useful only for clients (that is, if
"MapAddress \*.example.com \*.example.com.torserver.exit". (Note the
leading "*." in each part of the directive.) You can also redirect all
subdomains of a domain to a single address. For example, "MapAddress
- *.example.com www.example.com". +
+ *.example.com www.example.com". If the specified exit is not available,
+ or the exit can not connect to the site, Tor will fail any connections
+ to the mapped address.+
+
NOTES:
@@ -1181,6 +1183,15 @@ The following options are useful only for clients (that is, if
4. Using a wildcard to match only part of a string (as in *ample.com) is
also invalid.
+ 5. Tor maps hostnames and IP addresses separately. If you MapAddress
+ a DNS name, but use an IP address to connect, then Tor will ignore the
+ DNS name mapping.
+
+ 6. MapAddress does not apply to redirects in the application protocol.
+ For example, HTTP redirects and alt-svc headers will ignore mappings
+ for the original address. You can use a wildcard mapping to handle
+ redirects within the same site.
+
[[NewCircuitPeriod]] **NewCircuitPeriod** __NUM__::
Every NUM seconds consider whether to build a new circuit. (Default: 30
seconds)