commit 25b0d43a9ebe89541625e9f1a090e4a701748c76 Author: Desoxy desoxy@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