voting_schedule.h

Go to the documentation of this file.

/* 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) */