diff options
| author | teor <teor@torproject.org> | 2019-06-23 16:47:56 +1000 |
|---|---|---|
| committer | teor <teor@torproject.org> | 2019-06-23 16:47:56 +1000 |
| commit | e9627a9e5355b4801b1e7f0f4ae2f457c5f40325 (patch) | |
| tree | ee5ec234250133e2026e4c8a96f0aa95e683c539 /dir-list-spec.txt | |
| parent | ca1dea9b8a88e736afbc169a94f66960b722e95c (diff) | |
| download | torspec-e9627a9e5355b4801b1e7f0f4ae2f457c5f40325.tar.gz torspec-e9627a9e5355b4801b1e7f0f4ae2f457c5f40325.zip | |
dir-list: add a source line to the dir-list header
And create a new minor format version 2.1.0.
Closes 30949.
Diffstat (limited to 'dir-list-spec.txt')
| -rw-r--r-- | dir-list-spec.txt | 16 |
1 files changed, 16 insertions, 0 deletions
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.] |