microdesc_t Struct Reference

#include <or.h>

Public Member Functions
	HT_ENTRY (microdesc_t) node
Data Fields
time_t	last_listed
saved_location_t	saved_location: 3
unsigned int	no_save: 1
off_t	off
char *	body
size_t	bodylen
char	digest [DIGEST256_LEN]
crypto_pk_env_t *	onion_pkey
smartlist_t *	family
char *	exitsummary

---

Detailed Description

A microdescriptor is the smallest amount of information needed to build a circuit through a router. They are generated by the directory authorities, using information from the uploaded routerinfo documents. They are not self-signed, but are rather authenticated by having their hash in a signed networkstatus document.

---

Member Function Documentation

microdesc_t::HT_ENTRY

(

microdesc_t

)

Hashtable node, used to look up the microdesc by its digest.

---

Field Documentation

time_t microdesc_t::last_listed

When was this microdescriptor last listed in a consensus document? Once a microdesc has been unlisted long enough, we can drop it.

Referenced by microdescs_parse_from_string().

saved_location_t microdesc_t::saved_location

Where is this microdescriptor currently stored?

Referenced by microdesc_cache_rebuild(), and microdesc_free().

unsigned int microdesc_t::no_save

If true, do not attempt to cache this microdescriptor on disk.

Referenced by microdesc_cache_rebuild().

off_t microdesc_t::off

If saved_location == SAVED_IN_CACHE, this field holds the offset of the microdescriptor in the cache.

Referenced by microdesc_cache_rebuild(), and microdescs_parse_from_string().

char* microdesc_t::body

A pointer to the encoded body of the microdescriptor. If the saved_location is SAVED_IN_CACHE, then the body is a pointer into an mmap'd region. Otherwise, it is a malloc'd string. The string might not be NUL-terminated; take the length from bodylen.

Referenced by connection_dirserv_add_microdescs_to_outbuf(), microdesc_cache_rebuild(), microdesc_free(), and microdescs_parse_from_string().

size_t microdesc_t::bodylen

The length of the microdescriptor in body.

Referenced by connection_dirserv_add_microdescs_to_outbuf(), and microdescs_parse_from_string().

char microdesc_t::digest[DIGEST256_LEN]

A SHA256-digest of the microdescriptor.

Referenced by dirvote_format_microdesc_vote_line(), microdesc_cache_lookup_by_digest256(), and microdescs_parse_from_string().

crypto_pk_env_t* microdesc_t::onion_pkey

As routerinfo_t.onion_pkey

Referenced by microdesc_free(), and microdescs_parse_from_string().

smartlist_t* microdesc_t::family

As routerinfo_t.family

Referenced by microdesc_free(), and microdescs_parse_from_string().

char* microdesc_t::exitsummary

Encoded exit policy summary exit policy summary - XXX this probably should not stay a string.

Referenced by microdesc_free(), and microdescs_parse_from_string().

---

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

• or.h