[tor-commits] [torspec/master] Note that MAPADDRESS results can have mixed status codes.

[nickm@xxxxxxxxxxxxxx]

commit 1417af05de247d9f858863849d16a7185577d369
Author: Nick Mathewson <nickm@xxxxxxxxxxxxxx>
Date:   Tue Jul 28 23:41:03 2020 -0400

    Note that MAPADDRESS results can have mixed status codes.
    
    Closes #30123
---
 control-spec.txt | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt
index 0334639..b9fa729 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -169,9 +169,10 @@
     ReplyText = XXXX
     StatusCode = 3DIGIT
 
-  Multiple lines in a single reply from Tor to the controller are guaranteed to
-  share the same status code. Specific replies are mentioned below in section 3,
-  and described more fully in section 4.
+  Unless specified otherwise, multiple lines in a single reply from
+  Tor to the controller are guaranteed to share the same status
+  code. Specific replies are mentioned below in section 3, and
+  described more fully in section 4.
 
   [Compatibility note:  versions of Tor before 0.2.0.3-alpha sometimes
   generate AsyncReplies of the form "*(MidReplyLine / DataReplyLine)".
@@ -538,6 +539,14 @@
   a certain time, then it must explicitly un-map the address when that
   time has elapsed.
 
+  MapAddress replies MAY contain mixed status codes.
+
+  Example:
+
+    C: MAPADDRESS xxx=@@@ 0.0.0.0=bogus1.google.com
+    S: 512-syntax error: invalid address '@@@'
+    S: 250 127.199.80.246=bogus1.google.com
+
 3.9. GETINFO
 
   Sent from the client to the server.  The syntax is as for GETCONF:

_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits