[tor-commits] [torspec/master] Demonstrate how to remove MAPADDRESS entries

[dgoulet at torproject.org]

commit b443bc3603cc7b5d6e492b955fafc744ade54f04
Author: Damian Johnson <atagar at torproject.org>
Date:   Fri Aug 14 16:07:39 2020 -0700

    Demonstrate how to remove MAPADDRESS entries
    
    Our docs accurately describe how to remove MAPADDRESS entries, but doesn't
    demonstrate it. Exemplifying how to query our mappings and remove them.
    
      https://gitlab.torproject.org/tpo/core/tor/-/issues/40104
---
 control-spec.txt | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt
index e338d79..a5eaeee 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -516,9 +516,19 @@
 
   Example:
 
-    C: MAPADDRESS 0.0.0.0=torproject.org 1.2.3.4=tor.freehaven.net
-    S: 250-127.192.10.10=torproject.org
-    S: 250 1.2.3.4=tor.freehaven.net
+    C: MAPADDRESS 1.2.3.4=torproject.org
+    S: 250 1.2.3.4=torproject.org
+
+    C: GETINFO address-mappings/control
+    S: 250-address-mappings/control=1.2.3.4 torproject.org NEVER
+    S: 250 OK
+
+    C: MAPADDRESS 1.2.3.4=1.2.3.4
+    S: 250 1.2.3.4=1.2.3.4
+
+    C: GETINFO address-mappings/control
+    S: 250-address-mappings/control=
+    S: 250 OK
 
   {Note: This feature is designed to be used to help Tor-ify applications
   that need to use SOCKS4 or hostname-less SOCKS5.  There are three