Detailed Description
Holds configuration about our directory authority options.
Definition at line 13 of file dirauth_options.inc.
Field Documentation
◆ AuthDirFastGuarantee
| MEMUNIT AuthDirFastGuarantee |
If non-zero, always vote the Fast flag for any relay advertising this amount of capacity or more.
Definition at line 17 of file dirauth_options.inc.
Referenced by dirauth_options_pre_normalize(), and dirserv_compute_performance_thresholds().
◆ AuthDirGuardBWGuarantee
| MEMUNIT AuthDirGuardBWGuarantee |
If non-zero, this advertised capacity or more is always sufficient to satisfy the bandwidth requirement for the Guard flag.
Definition at line 21 of file dirauth_options.inc.
Referenced by dirauth_options_pre_normalize(), and dirauth_set_routerstatus_from_routerinfo().
◆ AuthDirHasIPv6Connectivity
| BOOL AuthDirHasIPv6Connectivity |
Boolean: are we on IPv6?
Definition at line 24 of file dirauth_options.inc.
Referenced by dirserv_set_router_is_running().
◆ AuthDirListBadExits
| BOOL AuthDirListBadExits |
True iff we should list bad exits, and vote for all other exits as good.
Definition at line 28 of file dirauth_options.inc.
Referenced by dirserv_generate_networkstatus_vote_obj().
◆ AuthDirListMiddleOnly
| BOOL AuthDirListMiddleOnly |
True iff we should list middle-only relays, and vote for all other relays as possibly suitable for other positions.
Definition at line 32 of file dirauth_options.inc.
Referenced by dirserv_generate_networkstatus_vote_obj().
◆ AuthDirMaxServersPerAddr
| POSINT AuthDirMaxServersPerAddr |
Do not permit more than this number of servers per IP address.
Definition at line 35 of file dirauth_options.inc.
Referenced by dirserv_generate_networkstatus_vote_obj(), and get_sybil_list_by_ip_version().
◆ AuthDirPinKeys
| BOOL AuthDirPinKeys |
Boolean: Do we enforce key-pinning?
Definition at line 38 of file dirauth_options.inc.
Referenced by dirserv_add_descriptor(), and dirserv_router_get_status().
◆ AuthDirRejectRequestsUnderLoad
| BOOL AuthDirRejectRequestsUnderLoad |
Boolean: Under bandwidth pressure, if set to 1, the authority will always answer directory requests from relays but will start sending 503 error code for the other connections. If set to 0, all connections are considered the same and the authority will try to answer them all regardless of bandwidth pressure or not.
Definition at line 143 of file dirauth_options.inc.
Referenced by dirauth_should_reject_requests_under_load().
◆ AuthDirSharedRandomness
| BOOL AuthDirSharedRandomness |
Bool (default: 1): Switch for the shared random protocol. Only relevant to a directory authority. If off, the authority won't participate in the protocol. If on (default), a flag is added to the vote indicating participation.
Definition at line 44 of file dirauth_options.inc.
Referenced by sr_get_string_for_consensus(), and sr_get_string_for_vote().
◆ AuthDirTestEd25519LinkKeys
| BOOL AuthDirTestEd25519LinkKeys |
Bool (default: 1): When testing routerinfos as a directory authority, do we enforce Ed25519 identity match?
Definition at line 49 of file dirauth_options.inc.
Referenced by dirserv_single_reachability_test().
◆ AuthDirTestReachability
| BOOL AuthDirTestReachability |
Bool (default 1): As an authority, should we launch tests for reachability, and use those results to vote on "Running"? If 0, we assume that every relay is Running.
Definition at line 56 of file dirauth_options.inc.
Referenced by dirserv_set_router_is_running().
◆ AuthDirVoteGuard
| ROUTERSET AuthDirVoteGuard |
Relays which should be voted Guard regardless of uptime and bandwidth.
Definition at line 83 of file dirauth_options.inc.
Referenced by dirserv_set_routerstatus_flags().
◆ AuthDirVoteGuardBwThresholdFraction
| DOUBLE AuthDirVoteGuardBwThresholdFraction |
The Guard flag bandwidth performance threshold fraction that is the fraction representing who gets the Guard flag out of all measured bandwidth.
Definition at line 106 of file dirauth_options.inc.
Referenced by dirauth_options_validate(), and dirserv_compute_performance_thresholds().
◆ AuthDirVoteGuardGuaranteeTimeKnown
| INTERVAL AuthDirVoteGuardGuaranteeTimeKnown |
A relay with at least this much weighted time known can be considered familiar enough to be a guard. (Corresponds to about 20 days for current decay rates.)
Definition at line 98 of file dirauth_options.inc.
Referenced by dirserv_compute_performance_thresholds().
◆ AuthDirVoteGuardGuaranteeWFU
| DOUBLE AuthDirVoteGuardGuaranteeWFU |
A relay with sufficient WFU is around enough to be a guard.
Definition at line 101 of file dirauth_options.inc.
Referenced by dirserv_compute_performance_thresholds().
◆ AuthDirVoteStableGuaranteeMinUptime
| INTERVAL AuthDirVoteStableGuaranteeMinUptime |
If a relay's uptime is at least this value, then it is always considered stable, regardless of the rest of the network. This way we resist attacks where an attacker doubles the size of the network using allegedly high-uptime nodes, displacing all the current guards.
Definition at line 89 of file dirauth_options.inc.
◆ AuthDirVoteStableGuaranteeMTBF
| INTERVAL AuthDirVoteStableGuaranteeMTBF |
If a relay's MTBF is at least this value, then it is always stable. See above. (Corresponds to about 7 days for current decay rates.)
Definition at line 93 of file dirauth_options.inc.
◆ ConsensusParams
| LINELIST ConsensusParams |
Authority only: key=value pairs that we add to our networkstatus consensus vote on the 'params' line.
Definition at line 60 of file dirauth_options.inc.
Referenced by dirserv_generate_networkstatus_vote_obj().
◆ MinimalAcceptedServerVersion
| STRING MinimalAcceptedServerVersion |
Which minimal version of tor do we accept relay descriptors from?
Definition at line 80 of file dirauth_options.inc.
Referenced by dirauth_options_validate().
◆ MinMeasuredBWsForAuthToIgnoreAdvertised
| INT MinMeasuredBWsForAuthToIgnoreAdvertised |
Authority only: minimum number of measured bandwidths we must see before we only believe measured bandwidths to assign flags.
Definition at line 64 of file dirauth_options.inc.
Referenced by dirserv_compute_performance_thresholds(), dirserv_get_credible_bandwidth_kb(), and dirserv_get_flag_thresholds_line().
◆ MinUptimeHidServDirectoryV2
| INTERVAL MinUptimeHidServDirectoryV2 |
As directory authority, accept hidden service directories after what time?
Definition at line 68 of file dirauth_options.inc.
◆ RecommendedClientVersions
| LINELIST RecommendedClientVersions |
Which versions of tor should we tell users to run on clients?
Definition at line 74 of file dirauth_options.inc.
Referenced by dirauth_options_pre_normalize(), dirauth_options_validate(), and dirserv_generate_networkstatus_vote_obj().
◆ RecommendedServerVersions
| LINELIST RecommendedServerVersions |
Which versions of tor should we tell users to run on relays?
Definition at line 77 of file dirauth_options.inc.
Referenced by dirauth_options_pre_normalize(), dirauth_options_validate(), and dirserv_generate_networkstatus_vote_obj().
◆ RecommendedVersions
| LINELIST RecommendedVersions |
Which versions of tor should we tell users to run?
Definition at line 71 of file dirauth_options.inc.
Referenced by dirauth_options_pre_normalize().
◆ TestingAuthDirTimeToLearnReachability
| INTERVAL TestingAuthDirTimeToLearnReachability |
If an authority has been around for less than this amount of time, it does not believe its reachability information is accurate. Only altered on testing networks.
Definition at line 111 of file dirauth_options.inc.
Referenced by dirauth_options_validate(), and running_long_enough_to_decide_unreachable().
◆ TestingDirAuthVoteExit
| ROUTERSET TestingDirAuthVoteExit |
Relays in a testing network which should be voted Exit regardless of exit policy.
Definition at line 115 of file dirauth_options.inc.
Referenced by dirserv_set_routerstatus_testing().
◆ TestingDirAuthVoteExitIsStrict
| BOOL TestingDirAuthVoteExitIsStrict |
Definition at line 116 of file dirauth_options.inc.
◆ TestingDirAuthVoteGuard
| ROUTERSET TestingDirAuthVoteGuard |
Relays in a testing network which should be voted Guard regardless of uptime and bandwidth.
Definition at line 120 of file dirauth_options.inc.
Referenced by dirserv_set_routerstatus_testing().
◆ TestingDirAuthVoteGuardIsStrict
| BOOL TestingDirAuthVoteGuardIsStrict |
Definition at line 121 of file dirauth_options.inc.
◆ TestingDirAuthVoteHSDir
| ROUTERSET TestingDirAuthVoteHSDir |
Relays in a testing network which should be voted HSDir regardless of uptime and DirPort.
Definition at line 125 of file dirauth_options.inc.
Referenced by dirserv_set_routerstatus_testing().
◆ TestingDirAuthVoteHSDirIsStrict
| BOOL TestingDirAuthVoteHSDirIsStrict |
Definition at line 126 of file dirauth_options.inc.
◆ TestingMinExitFlagThreshold
| MEMUNIT TestingMinExitFlagThreshold |
Minimum value for the Exit flag threshold on testing networks.
Definition at line 129 of file dirauth_options.inc.
Referenced by router_counts_toward_thresholds().
◆ TestingMinFastFlagThreshold
| MEMUNIT TestingMinFastFlagThreshold |
Minimum value for the Fast flag threshold on testing networks.
Definition at line 132 of file dirauth_options.inc.
Referenced by dirserv_compute_performance_thresholds().
◆ VersioningAuthoritativeDirectory
| BOOL VersioningAuthoritativeDirectory |
Boolean: is this an authoritative directory that's willing to recommend versions?
Definition at line 136 of file dirauth_options.inc.
Referenced by dirauth_options_validate(), and dirserv_generate_networkstatus_vote_obj().
The documentation for this struct was generated from the following file:
- feature/dirauth/dirauth_options.inc
Generated by
1.12.0