commit e9627a9e5355b4801b1e7f0f4ae2f457c5f40325 Author: teor teor@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.]