[tor-commits] [tor/master] Document that .onion subdomains are ignored by clients

nickm at torproject.org nickm at torproject.org
Tue Sep 19 17:03:27 UTC 2017


commit b74a1c77a4b81ebd8cc63ec108617645d396d9fd
Author: Nick Mathewson <nickm at torproject.org>
Date:   Tue Sep 19 09:25:44 2017 -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.
---
 changes/18736 | 3 +++
 doc/tor.1.txt | 5 +++++
 2 files changed, 8 insertions(+)

diff --git a/changes/18736 b/changes/18736
new file mode 100644
index 000000000..9cd48eb3a
--- /dev/null
+++ 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
index f669a055c..2083bb131 100644
--- 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.





More information about the tor-commits mailing list