dirlist.c File Reference

#include "core/or/or.h"
#include "app/config/config.h"
#include "core/or/policies.h"
#include "feature/control/control_events.h"
#include "feature/dirauth/authmode.h"
#include "feature/dircommon/directory.h"
#include "feature/nodelist/dirlist.h"
#include "feature/nodelist/networkstatus.h"
#include "feature/nodelist/nodelist.h"
#include "feature/nodelist/routerlist.h"
#include "feature/nodelist/routerset.h"
#include "feature/relay/router.h"
#include "lib/net/resolve.h"
#include "feature/dirclient/dir_server_st.h"
#include "feature/nodelist/node_st.h"

Go to the source code of this file.

Macros
#define	dir_server_free(val)   FREE_AND_NULL(dir_server_t, dir_server_free_, (val))

Functions
int	get_n_authorities (dirinfo_type_t type)
smartlist_t *	router_get_trusted_dir_servers_mutable (void)
smartlist_t *	router_get_fallback_dir_servers_mutable (void)
const smartlist_t *	router_get_trusted_dir_servers (void)
const smartlist_t *	router_get_fallback_dir_servers (void)
void	router_reset_status_download_failures (void)
dir_server_t *	router_get_trusteddirserver_by_digest (const char *digest)
dir_server_t *	router_get_fallback_dirserver_by_digest (const char *digest)
int	router_digest_is_fallback_dir (const char *digest)
	MOCK_IMPL (dir_server_t *, trusteddirserver_get_by_v3_auth_digest,(const char *digest))
void	mark_all_dirservers_up (smartlist_t *server_list)
int	router_digest_is_trusted_dir_type (const char *digest, dirinfo_type_t type)
static dir_server_t *	dir_server_new (int is_authority, const char *nickname, const tor_addr_t *addr, const char *hostname, uint16_t dir_port, uint16_t or_port, const tor_addr_port_t *addrport_ipv6, const char *digest, const char *v3_auth_digest, dirinfo_type_t type, double weight)
dir_server_t *	trusted_dir_server_new (const char *nickname, const char *address, uint16_t dir_port, uint16_t or_port, const tor_addr_port_t *ipv6_addrport, const char *digest, const char *v3_auth_digest, dirinfo_type_t type, double weight)
dir_server_t *	fallback_dir_server_new (const tor_addr_t *addr, uint16_t dir_port, uint16_t or_port, const tor_addr_port_t *addrport_ipv6, const char *id_digest, double weight)
void	dir_server_add (dir_server_t *ent)
static void	dir_server_free_ (dir_server_t *ds)
void	clear_dir_servers (void)
void	dirlist_free_all (void)

Variables
static smartlist_t *	trusted_dir_servers = NULL
static smartlist_t *	fallback_dir_servers = NULL

Detailed Description

Code to maintain our lists of directory authorities and fallback directories.

For the directory authorities, we have a list containing the public identity key, and contact points, for each authority. The authorities receive descriptors from relays, and publish consensuses, descriptors, and microdescriptors. This list is pre-configured.

Fallback directories are well-known, stable, but untrusted directory caches that clients which have not yet bootstrapped can use to get their first networkstatus consensus, in order to find out where the Tor network really is. This list is pre-configured in fallback_dirs.inc. Every authority also serves as a fallback.

Both fallback directories and directory authorities are are represented by a dir_server_t.

Definition in file dirlist.c.

Function Documentation

clear_dir_servers()

void clear_dir_servers

(

void

)

Remove all members from the list of dir servers.

Definition at line 398 of file dirlist.c.

References fallback_dir_servers, and SMARTLIST_FOREACH.

dir_server_add()

void dir_server_add

(

dir_server_t *

ent

)

Add a directory server to the global list(s).

Definition at line 366 of file dirlist.c.

References fallback_dir_servers, dir_server_t::is_authority, router_dir_info_changed(), smartlist_add(), and trusted_dir_servers.

dir_server_free_()

static void dir_server_free_ ( dir_server_t *  ds )

static

Free storage held in ds.

Definition at line 385 of file dirlist.c.

References dir_server_t::address, and tor_free.

dir_server_new()

static dir_server_t* dir_server_new ( int  is_authority, const char *  nickname, const tor_addr_t *  addr, const char *  hostname, uint16_t  dir_port, uint16_t  or_port, const tor_addr_port_t *  addrport_ipv6, const char *  digest, const char *  v3_auth_digest, dirinfo_type_t  type, double  weight  )

static

Create a directory server at address:port, with OR identity key digest which has DIGEST_LEN bytes. If address is NULL, add ourself. If is_authority, this is a directory authority. Return the new directory server entry on success or NULL on failure.

Definition at line 226 of file dirlist.c.

Referenced by fallback_dir_server_new().

fallback_dir_server_new()

dir_server_t* fallback_dir_server_new	(	const tor_addr_t *	addr,
		uint16_t	dir_port,
		uint16_t	or_port,
		const tor_addr_port_t *	addrport_ipv6,
		const char *	id_digest,
		double	weight
	)

Return a new dir_server_t for a fallback directory server at addr:or_port/dir_port, with identity key digest id_digest

Definition at line 353 of file dirlist.c.

References dir_server_new().

get_n_authorities()

int get_n_authorities

(

dirinfo_type_t

type

)

Return the number of directory authorities whose type matches some bit set in type

Definition at line 55 of file dirlist.c.

Referenced by fetch_bridge_descriptors(), and networkstatus_check_consensus_signature().

mark_all_dirservers_up()

void mark_all_dirservers_up

(

smartlist_t *

server_list

)

Mark as running every dir_server_t in server_list.

Definition at line 184 of file dirlist.c.

References control_event_networkstatus_changed_single(), node_t::is_running, routerstatus_t::last_dir_503_at, router_get_mutable_consensus_status_by_id(), and SMARTLIST_FOREACH_BEGIN.

Referenced by router_reset_status_download_failures().

MOCK_IMPL()

MOCK_IMPL	(	dir_server_t *	,
		trusteddirserver_get_by_v3_auth_digest	,
		(const char *digest)
	)

Return the dir_server_t for the directory authority whose v3 identity key hashes to digest, or NULL if no such authority is known.

Definition at line 166 of file dirlist.c.

References DIGEST_LEN, SMARTLIST_FOREACH, tor_memeq(), trusted_dir_servers, and V3_DIRINFO.

router_digest_is_fallback_dir()

int router_digest_is_fallback_dir

(

const char *

digest

)

Return 1 if any fallback dirserver's identity key hashes to digest, or 0 if no such fallback is in the list of fallback_dir_servers. (fallback_dir_servers is affected by the FallbackDir and UseDefaultFallbackDirs torrc options.) The list of fallback directories includes the list of authorities.

Definition at line 157 of file dirlist.c.

References router_get_fallback_dirserver_by_digest().

router_digest_is_trusted_dir_type()

int router_digest_is_trusted_dir_type	(	const char *	digest,
		dirinfo_type_t	type
	)

Return true iff digest is the digest of the identity key of a trusted directory matching at least one bit of type. If type is zero (NO_DIRINFO), or ALL_DIRINFO, any authority is okay.

Definition at line 208 of file dirlist.c.

router_get_fallback_dirserver_by_digest()

dir_server_t* router_get_fallback_dirserver_by_digest

(

const char *

digest

)

Return the dir_server_t for the fallback dirserver whose identity key hashes to digest, or NULL if no such fallback is in the list of fallback_dir_servers. (fallback_dir_servers is affected by the FallbackDir and UseDefaultFallbackDirs torrc options.) The list of fallback directories includes the list of authorities.

Definition at line 133 of file dirlist.c.

References DIGEST_LEN, fallback_dir_servers, SMARTLIST_FOREACH, and tor_memeq().

Referenced by router_digest_is_fallback_dir().

router_get_trusted_dir_servers_mutable()

smartlist_t* router_get_trusted_dir_servers_mutable

(

void

)

Return a smartlist containing a list of dir_server_t * for all known trusted dirservers. Callers must not modify the list or its contents.

Definition at line 71 of file dirlist.c.

References trusted_dir_servers.

router_get_trusteddirserver_by_digest()

dir_server_t* router_get_trusteddirserver_by_digest

(

const char *

digest

)

Return the dir_server_t for the directory authority whose identity key hashes to digest, or NULL if no such authority is known.

Definition at line 112 of file dirlist.c.

References DIGEST_LEN, SMARTLIST_FOREACH, tor_memeq(), and trusted_dir_servers.

router_reset_status_download_failures()

void router_reset_status_download_failures

(

void

)

Reset all internal variables used to count failed downloads of network status objects.

Definition at line 103 of file dirlist.c.

References fallback_dir_servers, and mark_all_dirservers_up().

trusted_dir_server_new()

dir_server_t* trusted_dir_server_new	(	const char *	nickname,
		const char *	address,
		uint16_t	dir_port,
		uint16_t	or_port,
		const tor_addr_port_t *	ipv6_addrport,
		const char *	digest,
		const char *	v3_auth_digest,
		dirinfo_type_t	type,
		double	weight
	)

Create an authoritative directory server at address:port, with identity key digest. If address is NULL, add ourself. Return the new trusted directory server entry on success or NULL if we couldn't add it.

Definition at line 308 of file dirlist.c.

Variable Documentation

fallback_dir_servers

smartlist_t* fallback_dir_servers = NULL

static

Global list of dir_server_t objects for all directory authorities and all fallback directory servers.

Definition at line 50 of file dirlist.c.

Referenced by clear_dir_servers(), dir_server_add(), router_get_fallback_dirserver_by_digest(), and router_reset_status_download_failures().

trusted_dir_servers

smartlist_t* trusted_dir_servers = NULL

static

Global list of a dir_server_t object for each directory authority.

Definition at line 47 of file dirlist.c.

Referenced by dir_server_add(), MOCK_IMPL(), router_get_trusted_dir_servers_mutable(), and router_get_trusteddirserver_by_digest().