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.]