tor

commit b74a1c77a4b81ebd8cc63ec108617645d396d9fd
parent 1f602e86433cc132981e8f9727266353ea2c3b0e
Author: Nick Mathewson <nickm@torproject.org>
Date:   Tue, 19 Sep 2017 09:25:44 -0400

Document that .onion subdomains are  ignored by clients

addr-spec.txt also explains this, but we should get it into the
manpage too.

Closes ticket #18736.

Diffstat:
A
changes/18736
 | 
3
+++
M
doc/tor.1.txt
 | 
5
+++++

2 files changed, 8 insertions(+), 0 deletions(-)
diff --git a/changes/18736 b/changes/18736
@@ -0,0 +1,3 @@
+  o Documentation:
+    - Document that onion service subdomains are allowed, and ignored.
+      Closes ticket 18736.
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
@@ -2989,6 +2989,11 @@ __HiddenServiceDirectory__**/hostname**::
     The <base32-encoded-fingerprint>.onion domain name for this hidden service.
     If the hidden service is restricted to authorized clients only, this file
     also contains authorization data for all clients.
+ +
+    Note that clients will ignore any extra subdomains prepended to a hidden
+    service hostname. So if you have "xyz.onion" as your hostname, you
+    can tell clients to connect to "www.xyz.onion" or "irc.xyz.onion"
+    for virtual-hosting purposes.
 
 __HiddenServiceDirectory__**/private_key**::
     The private key for this hidden service.