[tor-commits] [torspec/master] Add NETWORK_LIVENESS event type and network-liveness GETINFO key

[nickm at torproject.org]

commit 44aac630f69fc1bc1ab8cd33645f9f461de116a4
Author: Andrea Shepard <andrea at persephoneslair.org>
Date:   Sun May 17 13:46:18 2015 +0000

    Add NETWORK_LIVENESS event type and network-liveness GETINFO key
---
 control-spec.txt |   14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/control-spec.txt b/control-spec.txt
index cf2608c..0cc46b9 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -854,6 +854,10 @@
          HSAddress
       [New in Tor 0.2.7.1-alpha.]
 
+      "network-liveness"
+      The string "up" or "down", indicating whether we currently believe the
+      network is reachable.
+
   Examples:
      C: GETINFO version desc/name/moria1
      S: 250+desc/name/moria=
@@ -2782,6 +2786,16 @@
 
   [HS_DESC_CONTENT was added in Tor 0.2.7.1-alpha]
 
+4.1.27. Network liveness has changed
+
+  Syntax:
+     "650" SP "NETWORK_LIVENESS" SP Status ... CRLF
+     Status = "UP" | "DOWN"
+
+  The Status values are:
+    "UP"   -- The network now seems to be reachable.
+    "DOWN" -- The network now seems to be unreachable.
+
 5. Implementation notes
 
 5.1. Authentication