Tweak the documentation for approved-routers

Document !badexit, and improve the documentation for !invalid.

Closes #40188.
This commit is contained in:
Nick Mathewson 2020-12-09 14:08:15 -05:00
parent e74f168bb4
commit 34baa1bdc3
2 changed files with 9 additions and 3 deletions

4
changes/ticket40188 Normal file
View File

@ -0,0 +1,4 @@
o Minor features (documentation):
- Mention the !badexit directive that can appear in an authority's
approved-routers file, and update the description of the !invalid
directive. Closes ticket 40188.

View File

@ -3824,9 +3824,11 @@ __DataDirectory__/**`approved-routers`**::
**fingerprint** file in a tor relay's __DataDirectory__ for an example **fingerprint** file in a tor relay's __DataDirectory__ for an example
fingerprint line. If the status is **!reject**, then descriptors from the fingerprint line. If the status is **!reject**, then descriptors from the
given identity are rejected by this server. If it is **!invalid** then given identity are rejected by this server. If it is **!invalid** then
descriptors are accepted, but marked in the directory as not valid, that descriptors are accepted, but marked in the vote as not valid.
is, not recommended. In either case, the corresponding relays are not If it is **!badexit**, then the authority will vote for it to receive a
included in the consensus. BadExit flag, indicating that it shouldn't be used for traffic leaving
the Tor network.
(Neither rejected nor invalid relays are included in the consensus.)
__DataDirectory__/**`v3-status-votes`**:: __DataDirectory__/**`v3-status-votes`**::
Only for v3 authoritative directory servers. This file contains status Only for v3 authoritative directory servers. This file contains status