Data Fields
char *	new_address

time_t	expires

addressmap_entry_source_bitfield_t	source:3

unsigned	src_wildcard:1

unsigned	dst_wildcard:1

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

A mapping may be 'wildcarded'. If "src_wildcard" is true, then any address that ends with a . followed by the key for this entry will get remapped by it. If "dst_wildcard" is also true, then only the matching suffix of such addresses will get replaced by new_address.

Definition at line 57 of file addressmap.c.

Field Documentation

◆ dst_wildcard

unsigned dst_wildcard

Definition at line 62 of file addressmap.c.

◆ expires

time_t expires

Definition at line 59 of file addressmap.c.

◆ new_address

char* new_address

Definition at line 58 of file addressmap.c.

◆ num_resolve_failures

short num_resolve_failures

Definition at line 63 of file addressmap.c.

◆ source

addressmap_entry_source_bitfield_t source

Definition at line 60 of file addressmap.c.

◆ src_wildcard

unsigned src_wildcard

Definition at line 61 of file addressmap.c.

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

feature/client/addressmap.c

Data Fields