Tor  0.4.5.0-alpha-dev
Data Fields
dirauth_options_t Struct Reference

Data Fields

MEMUNIT AuthDirFastGuarantee
 
MEMUNIT AuthDirGuardBWGuarantee
 
BOOL AuthDirHasIPv6Connectivity
 
BOOL AuthDirListBadExits
 
POSINT AuthDirMaxServersPerAddr
 
BOOL AuthDirPinKeys
 
BOOL AuthDirSharedRandomness
 
BOOL AuthDirTestEd25519LinkKeys
 
BOOL AuthDirTestReachability
 
STRING ConsensusParams
 
INT MinMeasuredBWsForAuthToIgnoreAdvertised
 
INTERVAL MinUptimeHidServDirectoryV2
 
LINELIST RecommendedVersions
 
LINELIST RecommendedClientVersions
 
LINELIST RecommendedServerVersions
 
INTERVAL TestingAuthDirTimeToLearnReachability
 
ROUTERSET TestingDirAuthVoteExit
 
BOOL TestingDirAuthVoteExitIsStrict
 
ROUTERSET TestingDirAuthVoteGuard
 
BOOL TestingDirAuthVoteGuardIsStrict
 
ROUTERSET TestingDirAuthVoteHSDir
 
BOOL TestingDirAuthVoteHSDirIsStrict
 
MEMUNIT TestingMinExitFlagThreshold
 
MEMUNIT TestingMinFastFlagThreshold
 
BOOL VersioningAuthoritativeDirectory
 
BOOL AuthDirRejectRequestsUnderLoad
 

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().

◆ 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().

◆ AuthDirHasIPv6Connectivity

BOOL AuthDirHasIPv6Connectivity

Boolean: are we on IPv6?

Definition at line 24 of file dirauth_options.inc.

◆ 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.

◆ AuthDirMaxServersPerAddr

POSINT AuthDirMaxServersPerAddr

Do not permit more than this number of servers per IP address.

Definition at line 31 of file dirauth_options.inc.

◆ AuthDirPinKeys

BOOL AuthDirPinKeys

Boolean: Do we enforce key-pinning?

Definition at line 34 of file dirauth_options.inc.

◆ 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 110 of file dirauth_options.inc.

◆ 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 40 of file dirauth_options.inc.

◆ AuthDirTestEd25519LinkKeys

BOOL AuthDirTestEd25519LinkKeys

Bool (default: 1): When testing routerinfos as a directory authority, do we enforce Ed25519 identity match?

Definition at line 45 of file dirauth_options.inc.

◆ 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 Runnning.

Definition at line 52 of file dirauth_options.inc.

◆ ConsensusParams

STRING ConsensusParams

Authority only: key=value pairs that we add to our networkstatus consensus vote on the 'params' line.

Definition at line 56 of file dirauth_options.inc.

◆ 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 60 of file dirauth_options.inc.

◆ MinUptimeHidServDirectoryV2

INTERVAL MinUptimeHidServDirectoryV2

As directory authority, accept hidden service directories after what time?

Definition at line 64 of file dirauth_options.inc.

◆ RecommendedClientVersions

LINELIST RecommendedClientVersions

Which versions of tor should we tell users to run on clients?

Definition at line 70 of file dirauth_options.inc.

Referenced by dirauth_options_pre_normalize(), and dirauth_options_validate().

◆ RecommendedServerVersions

LINELIST RecommendedServerVersions

Which versions of tor should we tell users to run on relays?

Definition at line 73 of file dirauth_options.inc.

Referenced by dirauth_options_pre_normalize(), and dirauth_options_validate().

◆ RecommendedVersions

LINELIST RecommendedVersions

Which versions of tor should we tell users to run?

Definition at line 67 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 78 of file dirauth_options.inc.

◆ TestingDirAuthVoteExit

ROUTERSET TestingDirAuthVoteExit

Relays in a testing network which should be voted Exit regardless of exit policy.

Definition at line 82 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 87 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 92 of file dirauth_options.inc.

◆ TestingMinExitFlagThreshold

MEMUNIT TestingMinExitFlagThreshold

Minimum value for the Exit flag threshold on testing networks.

Definition at line 96 of file dirauth_options.inc.

◆ TestingMinFastFlagThreshold

MEMUNIT TestingMinFastFlagThreshold

Minimum value for the Fast flag threshold on testing networks.

Definition at line 99 of file dirauth_options.inc.

◆ VersioningAuthoritativeDirectory

BOOL VersioningAuthoritativeDirectory

Boolean: is this an authoritative directory that's willing to recommend versions?

Definition at line 103 of file dirauth_options.inc.

Referenced by dirauth_options_validate().


The documentation for this struct was generated from the following file: