Revise MapAddress manpage

make the asciidoc work; make the example more generic; tighten the
prose a little; be more specific that *.example.com matches
example.com; simplify an example.
This commit is contained in:
Nick Mathewson 2011-09-08 12:19:27 -04:00
parent ff3eb8e023
commit 00ecc22126

View File

@ -655,18 +655,19 @@ The following options are useful only for clients (that is, if
5050, 5190, 5222, 5223, 6523, 6667, 6697, 8300)
**MapAddress** __address__ __newaddress__::
When a request for address arrives to Tor, it will rewrite it to newaddress
When a request for address arrives to Tor, it will transform to newaddress
before processing it. For example, if you always want connections to
www.indymedia.org to exit via __torserver__ (where __torserver__ is the
nickname of the server), use MapAddress www.indymedia.org
www.indymedia.org.torserver.exit. If the value is prepended with a
'*.', it is treated as matching an entire domain. For example, if you
always want connections to any sub-domain of indymedia.org to exit via
www.example.com to exit via __torserver__ (where __torserver__ is the
nickname of the server), use "MapAddress www.example.com
www.example.com.torserver.exit". If the value is prefixed with a
"\*.", matches an entire domain. For example, if you
always want connections to example.com and any if its subdomains
to exit via
__torserver__ (where __torserver__ is the nickname of the server), use
MapAddress *.indymedia.org *.indymedia.org.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
*.indymedia.org www.indymedia.org. +
"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". +
+
NOTES:
@ -681,18 +682,16 @@ The following options are useful only for clients (that is, if
if you have the following in your torrc, www.torproject.org will map to
2.2.2.2:
MapAddress www.torproject.org 3.3.3.3
MapAddress 1.1.1.1 4.4.4.4
MapAddress 1.1.1.1 2.2.2.2
MapAddress www.torproject.org 1.1.1.1
3. The following MapAddress expression is invalid (and will be
ignored) because you cannot map from a specific address to a wildcarded
ignored) because you cannot map from a specific address to a wildcard
address:
MapAddress www.torproject.org *.torproject.org.torserver.exit
4. Using a wildcard as a regular expression (e.g. *ample.com) is
4. Using a wildcard to match only part of a string (as in *ample.com) is
also invalid.
**NewCircuitPeriod** __NUM__::