Struct HostContainer 

pub struct HostContainer {
    pub(super) lists: RwLock<[Vec<(Url, u64)>; 5]>,
}

Container for all hostlists. Uses a single lock for atomic cross-list operations.

Fields

lists: RwLock<[Vec<(Url, u64)>; 5]>

Implementations

impl HostContainer

fn new() -> Self

pub fn store(&self, color: HostColor, addr: Url, last_seen: u64)

Store or update an address on a hostlist.

pub fn store_and_trim(&self, color: HostColor, addr: Url, last_seen: u64)

Store, sort by last_seen (descending), and enforce max size.

pub fn remove(&self, color: HostColor, addr: &Url)

Remove an address from a hostlist if it exists.

pub fn contains(&self, color: HostColor, addr: &Url) -> bool

Check if an address exists in a hostlist.

pub fn contains_any(&self, colors: &[HostColor], addr: &Url) -> bool

Check if an address exists in any of the specified hostlists.

pub fn contains_hostname(&self, colors: &[HostColor], hostname: &str) -> bool

Check if any host with the given hostname exists in the specified lists.

pub fn is_empty(&self, color: HostColor) -> bool

Check if a hostlist is empty.

pub fn update_last_seen(&self, color: HostColor, addr: &Url, last_seen: u64)

Update the last_seen field for an address.

pub fn get_last_seen(&self, color: HostColor, addr: &Url) -> Option<u64>

Get the last_seen field for an address.

pub fn fetch_all(&self, color: HostColor) -> Vec<(Url, u64)>

Return all hosts from a hostlist.

pub fn fetch_last(&self, color: HostColor) -> Option<(Url, u64)>

Get the oldest entry (last in sorted list) from a hostlist.

pub fn fetch_with_schemes( &self, color: HostColor, schemes: &[String], limit: Option<usize>, ) -> Vec<(Url, u64)>

Get hosts matching the given transport schemes.

pub fn fetch_excluding_schemes( &self, color: HostColor, schemes: &[String], limit: Option<usize>, ) -> Vec<(Url, u64)>

Get hosts NOT matching the given transport schemes.

pub fn fetch_random_with_schemes( &self, color: HostColor, schemes: &[String], ) -> Option<(Url, u64)>

Get a random host matching the given schemes.

pub fn fetch_n_random(&self, color: HostColor, n: usize) -> Vec<(Url, u64)>

Get up to n random hosts.

pub fn fetch_n_random_with_schemes( &self, color: HostColor, schemes: &[String], n: usize, ) -> Vec<(Url, u64)>

Get up to n random hosts matching the given schemes.

pub fn fetch_n_random_excluding_schemes( &self, color: HostColor, schemes: &[String], n: usize, ) -> Vec<(Url, u64)>

Get up to n random hosts NOT matching the given schemes.

pub fn move_host( &self, addr: &Url, last_seen: u64, dest: HostColor, ) -> Result<()>

Atomically move a host between lists.

pub fn refresh(&self, color: HostColor, max_age: u64)

Remove entries older than max_age seconds.

pub fn load_all(&self, path: &str) -> Result<()>

pub fn save_all(&self, path: &str) -> Result<()>

pub fn mix_host( addr: &Url, transports: &[String], mixed_transports: &[String], tor_socks5_proxy: &Option<Url>, nym_socks5_proxy: &Option<Url>, ) -> Vec<Url>

Perform transport mixing for a URL, returning alternative connection addresses.