blob: 8d13e208b7238c67ae725059ef55d3500d20a42a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
/* Copyright (c) 2018-2021, The Tor Project, Inc. */
/* See LICENSE for licensing information */
/**
* \file voting_schedule.h
* \brief Header file for voting_schedule.c.
**/
#ifndef TOR_VOTING_SCHEDULE_H
#define TOR_VOTING_SCHEDULE_H
#include "core/or/or.h"
#ifdef HAVE_MODULE_DIRAUTH
/** Scheduling information for a voting interval. */
typedef struct {
/** When do we generate and distribute our vote for this interval? */
time_t voting_starts;
/** When do we send an HTTP request for any votes that we haven't
* been posted yet?*/
time_t fetch_missing_votes;
/** When do we give up on getting more votes and generate a consensus? */
time_t voting_ends;
/** When do we send an HTTP request for any signatures we're expecting to
* see on the consensus? */
time_t fetch_missing_signatures;
/** When do we publish the consensus? */
time_t interval_starts;
/** Our computed dirauth interval */
int interval;
/** True iff we have generated and distributed our vote. */
int have_voted;
/** True iff we've requested missing votes. */
int have_fetched_missing_votes;
/** True iff we have built a consensus and sent the signatures around. */
int have_built_consensus;
/** True iff we've fetched missing signatures. */
int have_fetched_missing_signatures;
/** True iff we have published our consensus. */
int have_published_consensus;
/* True iff this voting schedule was set on demand meaning not through the
* normal vote operation of a dirauth or when a consensus is set. This only
* applies to a directory authority that needs to recalculate the voting
* timings only for the first vote even though this object was initialized
* prior to voting. */
int created_on_demand;
/** The valid-after time of the last live consensus that filled this voting
* schedule. It's used to detect outdated voting schedules. */
time_t live_consensus_valid_after;
} voting_schedule_t;
/* Public API. */
extern voting_schedule_t voting_schedule;
void dirauth_sched_recalculate_timing(const or_options_t *options,
time_t now);
time_t dirauth_sched_get_next_valid_after_time(void);
time_t dirauth_sched_get_cur_valid_after_time(void);
int dirauth_sched_get_configured_interval(void);
#else /* !defined(HAVE_MODULE_DIRAUTH) */
#define dirauth_sched_recalculate_timing(opt,now) \
((void)(opt), (void)(now))
static inline time_t
dirauth_sched_get_next_valid_after_time(void)
{
tor_assert_unreached();
return 0;
}
static inline time_t
dirauth_sched_get_cur_valid_after_time(void)
{
tor_assert_unreached();
return 0;
}
static inline int
dirauth_sched_get_configured_interval(void)
{
tor_assert_unreached();
return 1;
}
#endif /* defined(HAVE_MODULE_DIRAUTH) */
#endif /* !defined(TOR_VOTING_SCHEDULE_H) */
|
