Struct RuleStore 

pub struct RuleStore { /* private fields */ }

Concurrent, lock-free access to the InnerRuleStore.

Reads are fully lock-free — they clone an Arc (~10ns) and read from an immutable snapshot. Writers clone the current store, apply the mutation, and swap atomically via ArcSwap::rcu.

This is the correct abstraction for SideDNS because reads (DNS server, HTTP proxy, WebSocket proxy) vastly outnumber writes (IPC add/remove).

Cloning

RuleStore wraps an Arc internally — cloning it is cheap and shares the same underlying data. All clones see writes immediately.

Implementations

impl RuleStore

pub fn new() -> Self

pub fn resolve(&self, domain: &str) -> Option<DnsRule>

Resolve a domain to its matching rule.

Lock-free. Safe to call from hot paths (DNS, proxy).

pub fn add(&self, rule: DnsRule) -> DnsRule

Add or replace a persistent rule.

pub fn add_all(&self, rules: Vec<DnsRule>) -> usize

Add or replace persistent rules.

pub fn add_ephemeral(&self, rule: DnsRule) -> DnsRule

Add or replace an ephemeral rule.

pub fn remove(&self, domain: &str) -> Option<DnsRule>

Remove the persistent rule for domain.

Returns true if a rule was removed.

pub fn remove_ephemeral(&self, domain: &str) -> Option<DnsRule>

Remove the ephemeral rule for domain.

Returns true if a rule was removed.

pub fn snapshot_persistent(&self) -> Vec<DnsRule>

Return a snapshot of all persistent rules.

Snapshot is consistent but may be stale by the time you use it. Only use for persistence (confy) and IPC list responses.

pub fn snapshot_all(&self) -> Vec<DnsRule>

Return a snapshot of all rules (ephemeral + persistent).

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Trait Implementations

impl Clone for RuleStore

fn clone(&self) -> RuleStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuleStore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RuleStore

fn default() -> Self

Returns the “default value” for a type.