aboutsummaryrefslogtreecommitdiff
path: root/dir-spec.txt
AgeCommit message (Collapse)Author
2023-10-12Move all text-only specifications into the OLD_TXT directory.Nick Mathewson
2023-08-15Close prop-301, describing the new consensus method 34 in dir-specNick Mathewson
See tor!743 for the implementation.
2023-05-08Fix typoGeorg Koppen
Closes: #199.
2023-01-26Merge branch 'tor-gitlab/mr/104'David Goulet
2023-01-20Clarify and tidy up KeywordLine ArgumentIan Jackson
* Introduce the notion of Argument, which is relied on in the rest of the document, but not defined here formally. Spec changes implied by this diff: * Forbid the arguments from containing form feeds, carriage returns, and vertical tabs. * Forbid trailing whitespace after the last argument. I'm not sure whether this is correct, but it seems anomalous to permit it for only for keyword lines with arguments, and not anywhere else.
2023-01-19Give a formal name to shared_random_valueIan Jackson
2023-01-17dir-spec: Make Object multiplicity "?", not "*".Nick Mathewson
We have never actually generated an Item with multiple Objects. What's more, neither the C tor implementation nor Arti actually supports parsing such and item.
2023-01-10Merge branch 'tor-gitlab/mr/93'David Goulet
2023-01-10Merge branch 'tor-gitlab/mr/94'David Goulet
2022-12-20Clarify that SRV is 256 bits.Nick Mathewson
2022-11-15Document the extra NL that sometimes comes with a descriptorNick Mathewson
This NL isn't so easy to remove in Tor, since some older control-port code depends on it IIRC. But not having documented it caused arti#637: let's explain that, so that the next unfortunate implementor doesn't hit it.
2022-10-31dir-spec: Expect authority.z to always be availableIan Jackson
And discuss the places where it is used.
2022-10-24Authorities shouldn't get Measured= keywordRoger Dingledine
Corresponds to the bugfixes for bugs 40698 and 40700. Also, document our MeasuredButAuthority= keyword that we include instead (but that nothing uses).
2022-07-08Describe behavior on authority certs from the past or future.Nick Mathewson
2022-03-24Merge remote-tracking branch 'nickm/prop275'Alexander Færøy
2022-03-16DNS timeouts are not causing overload anymoreGeorg Koppen
Closes: #81.
2022-01-19dir-spec: Add missing versions for HSv3 linesDavid Goulet
Signed-off-by: David Goulet <dgoulet@torproject.org>
2021-12-14Merge branch 'tor-gitlab/mr/55'David Goulet
2021-12-08Clarify how we derive ed25519 for cross-certification.Nick Mathewson
The descriptor format uses a curve25519->ed25519 conversion algorithm to cross-certify descriptors with their ntor onion keys. This patch clarifies two aspects of the algorithm: 1. When deriving a private key, how to derive the part of the private key that _isn't_ a point on the curve. 2. That there are two algorithms here, one for private->private and one for public->public.
2021-12-08Fold prop 335-middle-only-redux.md into the specs.Nick Mathewson
Also, mark it closed.
2021-11-09Mark proposal 275 as closed and fold it into dir-spec.Nick Mathewson
2021-11-01dir-spec: Mishap, the overload lines are already in the specDavid Goulet
Signed-off-by: David Goulet <dgoulet@torproject.org>
2021-11-01dir-spec: Merge prop328 into main specificationsDavid Goulet
Signed-off-by: David Goulet <dgoulet@torproject.org>
2021-10-22fix typos/etc in dir-specRoger Dingledine
2021-09-22dir-spec: Add 'Table of contents'Oleh Franchuk
2021-08-16Document supported range for bandwdith values in netstatusNick Mathewson
2021-04-20fixup! Fold proposal 328 into dir-spec.txtGeorge Kadianakis
2021-04-19Fold proposal 328 into dir-spec.txtGeorge Kadianakis
2021-04-07Rename extrainfo and extra info to extra-infojuga0
Closes #41
2021-03-10dir-spec: Add "stats" line to a voteDavid Goulet
Signed-off-by: David Goulet <dgoulet@torproject.org>
2021-02-24Document the "Sybil" relay flag.George Kadianakis
2021-01-13Merge remote-tracking branch 'tor-gitlab/mr/24'George Kadianakis
2020-12-17dir-spec: Remove the notion of a "current" location in our ed diffsNick Mathewson
Tor has never generated or implemented this diff command. Found while working on arti.
2020-12-09Document consensus method 31 as a fix for bug #19011.Nick Mathewson
2020-11-17Merge branch 'tor-gitlab/mr/15' into masterDavid Goulet
2020-11-16fix typos; more robust links between specsRoger Dingledine
2020-10-30Merge remote-tracking branch 'tor-gitlab/mr/14' into masterGeorge Kadianakis
2020-10-28Merge remote-tracking branch 'gitlab/mr/13'Alexander Færøy
2020-10-27dir-spec.txt: Introduce extrainfo fields for v3 stats.George Kadianakis
2020-10-16Document newly required fields from prop315.Nick Mathewson
2020-10-14Lower the limit for allowed protocol versions.Nick Mathewson
This change merges proposal 318.
2020-10-14Describe our algorithm for waiting between directory retriesNick Mathewson
Closes torspec#25
2020-10-13Merge remote-tracking branch 'tor-gitlab/mr/6'Nick Mathewson
2020-09-28Split out list of consensus parameters into a new file.Nick Mathewson
No editing yet; only movement.
2020-09-18Better description for when a consensus must is "too early"Nick Mathewson
Since the authorities can produce a signed consensus as soon as `ValidAfter` minus `DistSeconds`, and since they serve a signed consensus as soon as it has enough signatures, it's possible that a client or relay that's starting late in the hour can get an "early" consensus. Back in tor#25756, we fixed this issue in Tor, but we didn't document the behavior in the spec.
2020-09-17Update dirspec to reflect REASONABLY_LIVE_TIME.Nick Mathewson
2020-09-17remove reference to a missing "download all microdescs" feature.Nick Mathewson
2020-09-17Clarify routerdesc expiration.Nick Mathewson
2020-09-17Clarify ed25519 signatures on routerdescs.Nick Mathewson
2020-09-17dir-spec: Correct description for keyword, beginline, endline.Nick Mathewson
A keyword may not begin with '-'. Otherwise, "-----BEGIN" would be a keyword, and the grammar would be ambiguous. A beginline or endline may have multiple words in its tag.
7apu2bq3rhoylwmucxizk54afw5jyda7pho4j5zdcqpwkufke7zdzwad.onion