commit 1417af05de247d9f858863849d16a7185577d369 Author: Nick Mathewson nickm@torproject.org 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: