[tor-commits] [torspec/master] dir-list: add a source line to the dir-list header

[nickm at torproject.org]

commit e9627a9e5355b4801b1e7f0f4ae2f457c5f40325
Author: teor <teor at torproject.org>
Date:   Sun Jun 23 16:47:56 2019 +1000

    dir-list: add a source line to the dir-list header
    
    And create a new minor format version 2.1.0.
    
    Closes 30949.
---
 dir-list-spec.txt | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/dir-list-spec.txt b/dir-list-spec.txt
index 3087246..1072904 100644
--- a/dir-list-spec.txt
+++ b/dir-list-spec.txt
@@ -68,6 +68,8 @@
    2.0.0 - Adds name and extrainfo structured comments, and section separator
            comments to make the list easier to parse.
 
+   2.1.0 - Adds a source list comment to the header.
+
 2. Format Details
 
    Directory lists contain the following sections:
@@ -174,6 +176,20 @@
 
        The current timestamp format is YYYYMMDDHHMMSS, as an integer.
 
+     "/*" SP+ "source=" Keyword SP+ "*/" SP* NL
+
+       [Zero or one time.]
+
+       The source of the directory entries in the list.
+
+       As of version 2.1.0, the sources are:
+         * "whitelist" - the fallback.whitelist file in the fallback-scripts
+                         repository. This is the default.
+         * "fallback"  - a fallback_dirs.inc file from a tor repository.
+                         Used in check_existing mode.
+
+       This line was added in version 2.1.0 of this specification.
+
      "/*" SP+ key_value SP+ "*/" SP* NL
 
        [Zero or more times.]