addressmap_entry_t Struct Reference

Data Fields
char *	new_address
time_t	expires
addressmap_entry_source_t	source:3
short	num_resolve_failures

---

Detailed Description

A client-side struct to remember requests to rewrite addresses to new addresses. These structs are stored in the hash table "addressmap" below.

There are 5 ways to set an address mapping:

• A MapAddress command from the controller [permanent]
• An AddressMap directive in the torrc [permanent]
• When a TrackHostExits torrc directive is triggered [temporary]
• When a DNS resolve succeeds [temporary]
• When a DNS resolve fails [temporary]

When an addressmap request is made but one is already registered, the new one is replaced only if the currently registered one has no "new_address" (that is, it's in the process of DNS resolve), or if the new one is permanent (expires==0 or 1).

(We overload the 'expires' field, using "0" for mappings set via the configuration file, "1" for mappings set from the control interface, and other values for DNS and TrackHostExit mappings that can expire.)

---

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

• connection_edge.c