
<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto">Hi,<div><br><div>On 27 Dec 2017, at 21:53, teor <<a href="mailto:teor2345@gmail.com">teor2345@gmail.com</a>> wrote:<br></div><blockquote type="cite"><div><span></span><br><blockquote type="cite"><span>On 26 Dec 2017, at 18:47, teor <<a href="mailto:teor2345@gmail.com">teor2345@gmail.com</a>> wrote:</span><br></blockquote><blockquote type="cite"><span></span><br></blockquote><blockquote type="cite"><blockquote type="cite"><span>On 25 Dec 2017, at 07:26, Iain Learmonth <<a href="mailto:irl@torproject.org">irl@torproject.org</a>> wrote:</span><br></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span></span><br></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span>As we are planning to also add a parser to metrics-lib (#24434), would</span><br></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span>it be possible to get a full description of the format of the file</span><br></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span>possibly in RFC5234 format so that we can check that the generator and</span><br></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span>parsers all match up to that specification?</span><br></blockquote></blockquote><blockquote type="cite"><span></span><br></blockquote><blockquote type="cite"><span>I have written up a format in the standard torspec style:</span><br></blockquote><blockquote type="cite"><span></span><br></blockquote><blockquote type="cite"><span><a href="https://github.com/teor2345/torspec/blob/fallback-format-2/fallback-spec.txt">https://github.com/teor2345/torspec/blob/fallback-format-2/fallback-spec.txt</a></span><br></blockquote><blockquote type="cite"><span></span><br></blockquote><blockquote type="cite"><span>It is deliberately under-specified, please let me know if this causes</span><br></blockquote><blockquote type="cite"><span>any trouble when writing the parser, and I will tighten it up.</span><br></blockquote><blockquote type="cite"><span></span><br></blockquote><blockquote type="cite"><span>It's not ABNF/RFC5234, it's rather restrictive, and strict ABNF is</span><br></blockquote><blockquote type="cite"><span>unreadable for case sensitive strings. I am happy to put an ABNF spec in</span><br></blockquote><blockquote type="cite"><span>an appendix, if someone wants to write one.</span><br></blockquote><span></span><br><span>We've added separators to each section, and a timestamp field in the header.</span><br><span></span><br><span>The revised spec is here:</span><br><span></span><br><span><a href="https://github.com/teor2345/torspec/blob/fallback-format-2/fallback-spec.txt">https://github.com/teor2345/torspec/blob/fallback-format-2/fallback-spec.txt</a></span><br><span></span><br><span>The revised sample file is here:</span><br><span></span><br><span><a href="https://trac.torproject.org/projects/tor/attachment/ticket/22759/fallback_dirs_new_format_version.4.inc">https://trac.torproject.org/projects/tor/attachment/ticket/22759/fallback_dirs_new_format_version.4.inc</a></span><br><span></span><br><span>We're tracking the details in this ticket:</span><br><span></span><br><span><a href="https://trac.torproject.org/projects/tor/ticket/24742">https://trac.torproject.org/projects/tor/ticket/24742</a></span><br></div></blockquote><br><div>We have merged the list format change to Tor's master branch.</div><div><br></div><div>The fallback 2.0.0 spec hasn't been merged yet, but atagar has reviewed it.</div><div>It's at:</div><div><span style="background-color: rgba(255, 255, 255, 0);"><a href="https://github.com/teor2345/torspec/blob/fallback-format-2-v2/fallback-spec.txt">https://github.com/teor2345/torspec/blob/fallback-format-2-v2/fallback-spec.txt</a></span></div><div><br></div><div>The fallback list is now in the 2.0.0 format, but it has exactly the same fallbacks in it:</div><div><a href="https://gitweb.torproject.org/tor.git/tree/src/or/fallback_dirs.inc">https://gitweb.torproject.org/tor.git/tree/src/or/fallback_dirs.inc</a></div><div><br></div><div>Some time over the next few days, we will generate a new list of fallbacks in</div><div>the 2.0.0 format, and backport it to Tor 0.2.9 and later.</div><div><br></div><div>T</div></div></body></html>