[tor-commits] [torspec/master] contol-spec: Add "CACHED" keyword to ADDRMAP events (#8596)

[nickm at torproject.org]

commit 25b0d43a9ebe89541625e9f1a090e4a701748c76
Author: Desoxy <desoxy at fastmail.fm>
Date:   Wed Apr 3 19:22:51 2013 +0200

    contol-spec: Add "CACHED" keyword to ADDRMAP events (#8596)
---
 control-spec.txt |    8 +++++++-
 1 files changed, 7 insertions(+), 1 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt
index 0219542..4498fbe 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -1579,7 +1579,8 @@
 
   Syntax:
      "650" SP "ADDRMAP" SP Address SP NewAddress SP Expiry
-       [SP "error=" ErrorCode] [SP "EXPIRES=" UTCExpiry] CRLF
+       [SP "error=" ErrorCode] [SP "EXPIRES=" UTCExpiry] [SP "CACHED=" Cached]
+       CRLF
 
      NewAddress = Address / "<error>"
      Expiry = DQUOTE ISOTime DQUOTE / "NEVER"
@@ -1587,6 +1588,8 @@
      ErrorCode = "yes" / "internal" / "Unable to launch resolve request"
      UTCExpiry = DQUOTE IsoTime DQUOTE
 
+     Cached = "YES" / "NO"
+
   Error and UTCExpiry are only provided if extended events are enabled.
   The values for Error are mostly useless.  Future values will be
   chosen to match 1*(ALNUM / "_"); the "Unable to launch resolve request"
@@ -1596,6 +1599,9 @@
   left in for backward compatibility; new code should look at UTCExpiry
   instead.  (If Expiry is "NEVER", UTCExpiry is omitted.)
 
+  Cached indicates whether the mapping will be stored until it expires, or if
+  it is just a notification in response to a RESOLVE command.
+
 4.1.8. Descriptors uploaded to us in our role as authoritative dirserver
 
   Tor generates this event when it's an directory authority, and