#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(), getinfo_helper_dir(), router_parse_entry_from_string(), routerlist_reparse_old(), signed_desc_append_to_journal(), and signed_descriptor_get_body_impl().

◆ do_not_cache

unsigned int do_not_cache

Definition at line 55 of file signed_descriptor_st.h.

◆ 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.

Referenced by dir_routerdesc_download_failed(), dirserv_add_extrainfo(), router_load_extrainfo_from_string(), and update_extrainfo_downloads().

◆ 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 extrainfo_insert(), get_signed_descriptor_by_fp(), router_dump_router_to_string(), router_parse_entry_from_string(), router_update_routerinfo_from_extrainfo(), routerinfo_incompatible_with_extrainfo(), routerlist_assert_ok(), routerlist_insert(), routerlist_insert_old(), routerlist_remove(), routerlist_remove_old(), routerlist_replace(), and update_extrainfo_downloads().

◆ 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 router_dump_router_to_string(), router_parse_entry_from_string(), router_update_routerinfo_from_extrainfo(), and routerinfo_incompatible_with_extrainfo().

◆ extrainfo_is_bogus

unsigned int extrainfo_is_bogus

Definition at line 60 of file signed_descriptor_st.h.

◆ 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(), authority_cert_parse_from_string(), compare_old_routers_by_identity_(), compare_routerinfo_by_id_digest_(), compare_routerinfo_usefulness(), directory_get_from_dirserver(), dirserv_add_descriptor(), dirserv_add_extrainfo(), dirserv_compute_performance_thresholds(), dirserv_get_bandwidth_for_router_kb(), dirserv_get_credible_bandwidth_kb(), dirserv_get_routerdesc_spool(), dirserv_router_get_status(), dirserv_set_router_is_running(), dirserv_single_reachability_test(), dirserv_thinks_router_is_hs_dir(), dirserv_thinks_router_is_unreliable(), dirvote_act(), dirvote_add_vote(), dirvote_create_microdescriptor(), dirvote_get_vote(), extend_info_from_router(), extrainfo_dump_to_string_header_helper(), extrainfo_insert(), extrainfo_parse_entry_from_string(), format_networkstatus_vote(), get_configured_bridge_by_routerinfo(), handle_get_descriptor(), learned_bridge_descriptor(), log_heartbeat(), networkstatus_check_document_signature(), networkstatus_parse_vote_from_string(), nodelist_remove_routerinfo(), nodelist_set_routerinfo(), router_add_to_routerlist(), router_build_fresh_unsigned_extrainfo(), router_build_fresh_unsigned_routerinfo(), router_describe(), router_get_verbose_nickname(), router_is_me(), router_parse_entry_from_string(), routerinfo_incompatible_with_extrainfo(), routerlist_add_node_and_family(), routerlist_insert(), routerlist_remove(), routerlist_remove_old_cached_routers_with_id(), routerlist_remove_old_routers(), routerlist_replace(), routerset_contains_router(), set_routerstatus_from_routerinfo(), signed_desc_digest_is_recognized(), trusted_dirs_load_certs_from_string(), and update_extrainfo_downloads().

◆ is_extrainfo

unsigned int is_extrainfo

Definition at line 57 of file signed_descriptor_st.h.

◆ 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.

Referenced by routerlist_remove_old_cached_routers_with_id(), and routerlist_remove_old_routers().

◆ published_on

time_t published_on

Declared publication time of the descriptor.

Definition at line 33 of file signed_descriptor_st.h.

Referenced by authdir_wants_to_reject_router(), authority_cert_parse_from_string(), compare_old_routers_by_identity_(), compare_signed_descriptors_by_age_(), controller_get_routerdescs(), dirauth_set_routerstatus_from_routerinfo(), dirserv_add_descriptor(), dirserv_set_router_is_running(), extrainfo_dump_to_string_header_helper(), extrainfo_parse_entry_from_string(), real_uptime(), router_add_to_routerlist(), router_build_fresh_unsigned_extrainfo(), router_build_fresh_unsigned_routerinfo(), router_descriptor_is_older_than(), router_differences_are_cosmetic(), router_dump_router_to_string(), router_is_active(), router_parse_entry_from_string(), routerinfo_incompatible_with_extrainfo(), routerlist_remove_old_cached_routers_with_id(), routerlist_remove_old_routers(), routers_make_ed_keys_unique(), spooled_resource_lookup_body(), trusted_dirs_load_certs_from_string(), and trusted_dirs_remove_old_certs().

◆ 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 router_build_fresh_unsigned_routerinfo(), router_parse_entry_from_string(), routerlist_insert(), routerlist_insert_old(), routerlist_remove(), routerlist_remove_old(), routerlist_remove_old_routers(), routerlist_replace(), routers_update_all_from_networkstatus(), 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 authority_cert_dup(), authority_cert_parse_from_string(), router_get_my_descriptor(), router_parse_list_from_string(), signed_desc_append_to_journal(), 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 router_parse_list_from_string(), signed_desc_append_to_journal(), and signed_descriptor_get_body_impl().

◆ send_unencrypted

unsigned int send_unencrypted

Definition at line 62 of file signed_descriptor_st.h.

◆ 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_dup(), authority_cert_free_(), authority_cert_parse_from_string(), dirserv_add_descriptor(), extrainfo_free_(), extrainfo_parse_entry_from_string(), format_networkstatus_vote(), init_keys(), router_dump_and_sign_extrainfo_descriptor_body(), router_dump_and_sign_routerinfo_descriptor_body(), router_parse_entry_from_string(), router_upload_dir_desc_to_dirservers(), routerinfo_free_(), signed_descriptor_free_(), signed_descriptor_get_body_impl(), 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 authority_cert_parse_from_string(), dirserv_add_descriptor(), dirserv_add_extrainfo(), extrainfo_insert(), extrainfo_parse_entry_from_string(), router_add_to_routerlist(), router_dump_and_sign_extrainfo_descriptor_body(), router_dump_and_sign_routerinfo_descriptor_body(), router_extrainfo_digest_is_me(), router_parse_entry_from_string(), router_update_routerinfo_from_extrainfo(), routerinfo_incompatible_with_extrainfo(), routerlist_insert(), routerlist_insert_old(), routerlist_remove(), routerlist_remove_old(), routerlist_remove_old_cached_routers_with_id(), routerlist_remove_old_routers(), routerlist_replace(), routers_make_ed_keys_unique(), routerstatus_format_entry(), set_routerstatus_from_routerinfo(), signed_desc_digest_is_recognized(), and update_consensus_router_descriptor_downloads().

◆ 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 authority_cert_dup(), authority_cert_parse_from_string(), dirserv_add_descriptor(), dirserv_add_extrainfo(), dump_routerlist_mem_usage(), extrainfo_insert(), extrainfo_parse_entry_from_string(), format_networkstatus_vote(), getinfo_helper_dir(), getinfo_helper_events(), handle_get_keys(), munge_extrainfo_into_routerinfo(), router_dump_and_sign_extrainfo_descriptor_body(), router_dump_and_sign_routerinfo_descriptor_body(), router_get_my_descriptor(), router_parse_entry_from_string(), router_upload_dir_desc_to_dirservers(), routerlist_insert(), routerlist_remove(), routerlist_remove_old(), routerlist_reparse_old(), routerlist_replace(), signed_desc_append_to_journal(), signed_descriptor_get_body_impl(), and spooled_resource_lookup_body().

◆ signing_key_cert

struct tor_cert_st* signing_key_cert

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

feature/nodelist/signed_descriptor_st.h

Data Fields