From 1417af05de247d9f858863849d16a7185577d369 Mon Sep 17 00:00:00 2001 From: Nick Mathewson Date: Tue, 28 Jul 2020 23:41:03 -0400 Subject: Note that MAPADDRESS results can have mixed status codes. Closes #30123 --- control-spec.txt | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) (limited to 'control-spec.txt') 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: -- cgit v1.2.3-54-g00ecf