signed_descriptor_t Struct Reference

#include <signed_descriptor_st.h>

Data Fields
char *	signed_descriptor_body
size_t	annotations_len
size_t	signed_descriptor_len
char	signed_descriptor_digest [DIGEST_LEN]
char	identity_digest [DIGEST_LEN]
time_t	published_on
char	extra_info_digest [DIGEST_LEN]
char	extra_info_digest256 [DIGEST256_LEN]
struct tor_cert_st *	signing_key_cert
download_status_t	ei_dl_status
saved_location_t	saved_location
off_t	saved_offset
int	routerlist_index
time_t	last_listed_as_valid_until
unsigned int	do_not_cache: 1
unsigned int	is_extrainfo: 1
unsigned int	extrainfo_is_bogus: 1
unsigned int	send_unencrypted: 1

Detailed Description

Information need to cache an onion router's descriptor.

Definition at line 18 of file signed_descriptor_st.h.

Field Documentation

annotations_len

size_t annotations_len

Length of the annotations preceding the server descriptor.

Definition at line 24 of file signed_descriptor_st.h.

Referenced by dirserv_add_descriptor(), routerlist_reparse_old(), and signed_descriptor_get_body_impl().

ei_dl_status

download_status_t ei_dl_status

For routerdescs only: Status of downloading the corresponding extrainfo.

Definition at line 42 of file signed_descriptor_st.h.

extra_info_digest

char extra_info_digest[DIGEST_LEN]

For routerdescs only: digest of the corresponding extrainfo.

Definition at line 35 of file signed_descriptor_st.h.

Referenced by get_signed_descriptor_by_fp(), and routerinfo_incompatible_with_extrainfo().

extra_info_digest256

char extra_info_digest256[DIGEST256_LEN]

For routerdescs only: A SHA256-digest of the extrainfo (if any)

Definition at line 37 of file signed_descriptor_st.h.

Referenced by routerinfo_incompatible_with_extrainfo().

identity_digest

char identity_digest[DIGEST_LEN]

Identity digest of the router.

Definition at line 31 of file signed_descriptor_st.h.

Referenced by already_have_cert(), compare_old_routers_by_identity_(), compare_routerinfo_by_id_digest_(), dirserv_add_extrainfo(), dirserv_get_bandwidth_for_router_kb(), dirserv_get_credible_bandwidth_kb(), dirserv_thinks_router_is_unreliable(), extrainfo_insert(), get_configured_bridge_by_routerinfo(), learned_bridge_descriptor(), log_heartbeat(), nodelist_remove_routerinfo(), nodelist_set_routerinfo(), router_describe(), router_is_me(), routerinfo_incompatible_with_extrainfo(), routerlist_add_node_and_family(), routerlist_insert(), and routerset_contains_router().

last_listed_as_valid_until

time_t last_listed_as_valid_until

The valid-until time of the most recent consensus that listed this descriptor. 0 for "never listed in a consensus, so far as we know."

Definition at line 53 of file signed_descriptor_st.h.

published_on

time_t published_on

Declared publication time of the descriptor.

Definition at line 33 of file signed_descriptor_st.h.

Referenced by compare_old_routers_by_identity_(), compare_signed_descriptors_by_age_(), real_uptime(), router_descriptor_is_older_than(), router_differences_are_cosmetic(), router_is_active(), routerinfo_incompatible_with_extrainfo(), and routers_make_ed_keys_unique().

routerlist_index

int routerlist_index

What position is this descriptor within routerlist->routers or routerlist->old_routers? -1 for none.

Definition at line 50 of file signed_descriptor_st.h.

Referenced by routerlist_insert(), routerlist_insert_old(), routerlist_remove(), routerlist_remove_old(), routerlist_replace(), and signed_descriptor_move().

saved_location

saved_location_t saved_location

Where is the descriptor saved?

Definition at line 44 of file signed_descriptor_st.h.

Referenced by router_get_my_descriptor(), and signed_descriptor_get_body_impl().

saved_offset

off_t saved_offset

If saved_location is SAVED_IN_CACHE or SAVED_IN_JOURNAL, the offset of this descriptor in the corresponding file.

Definition at line 47 of file signed_descriptor_st.h.

Referenced by signed_descriptor_get_body_impl().

signed_descriptor_body

char* signed_descriptor_body

Pointer to the raw server descriptor, preceded by annotations. Not necessarily NUL-terminated. If saved_location is SAVED_IN_CACHE, this pointer is null.

Definition at line 22 of file signed_descriptor_st.h.

Referenced by authority_cert_free_(), routerinfo_free_(), signed_descriptor_free_(), signed_descriptor_move(), and signed_descriptor_reset().

signed_descriptor_digest

char signed_descriptor_digest[DIGEST_LEN]

Digest of the server descriptor, computed as specified in dir-spec.txt.

Definition at line 29 of file signed_descriptor_st.h.

Referenced by extrainfo_insert(), router_extrainfo_digest_is_me(), routerinfo_incompatible_with_extrainfo(), routerlist_insert(), and routers_make_ed_keys_unique().

signed_descriptor_len

size_t signed_descriptor_len

Length of the server descriptor.

Definition at line 26 of file signed_descriptor_st.h.

Referenced by dirserv_add_descriptor(), dump_routerlist_mem_usage(), munge_extrainfo_into_routerinfo(), router_get_my_descriptor(), routerlist_reparse_old(), and signed_descriptor_get_body_impl().

signing_key_cert

struct tor_cert_st* signing_key_cert

Certificate for ed25519 signing key.

Definition at line 39 of file signed_descriptor_st.h.

Referenced by extrainfo_dump_to_string(), node_get_ed25519_id(), routerinfo_incompatible_with_extrainfo(), and signed_descriptor_move().

---

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

• feature/nodelist/signed_descriptor_st.h