entry_guard_t Struct Reference

Data Fields
char	nickname [MAX_NICKNAME_LEN+1]
char	identity [DIGEST_LEN]
time_t	chosen_on_date
char *	chosen_by_version
unsigned int	made_contact: 1
unsigned int	can_retry: 1
time_t	bad_since
time_t	unreachable_since
time_t	last_attempted

---

Detailed Description

An entry_guard_t represents our information about a chosen long-term first hop, known as a "helper" node in the literature. We can't just use a routerinfo_t, since we want to remember these even when we don't have a directory.

---

Field Documentation

time_t entry_guard_t::chosen_on_date

Approximately when was this guard added? "0" if we don't know.

Referenced by add_an_entry_guard(), and remove_obsolete_entry_guards().

char* entry_guard_t::chosen_by_version

What tor version added this guard? NULL if we don't know.

Referenced by add_an_entry_guard(), entry_guard_free(), and remove_obsolete_entry_guards().

unsigned int entry_guard_t::made_contact

0 if we have never connected to this router, 1 if we have.

Referenced by entry_guards_parse_state().

unsigned int entry_guard_t::can_retry

Should we retry connecting to this entry, in spite of having it marked as unreachable?

Referenced by add_an_entry_guard(), and entry_is_live().

time_t entry_guard_t::bad_since

0 if this guard is currently usable, or the time at which it was observed to become (according to the directory or the user configuration) unusable.

Referenced by add_an_entry_guard(), entry_guard_set_status(), entry_guards_parse_state(), entry_is_live(), and remove_dead_entry_guards().

time_t entry_guard_t::unreachable_since

0 if we can connect to this guard, or the time at which we first noticed we couldn't connect to it.

Referenced by entry_guards_parse_state(), entry_is_live(), and entry_is_time_to_retry().

time_t entry_guard_t::last_attempted

0 if we can connect to this guard, or the time at which we last failed to connect to it.

Referenced by entry_guards_parse_state(), and entry_is_time_to_retry().

---

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

• circuitbuild.c