Struct BindingDefaults 

pub struct BindingDefaults {
    pub mac_address: Option<String>,
    pub interface: Option<String>,
    pub host: Option<String>,
    pub port: Option<u16>,
}

Default binding parameters for a protocol

Protocols can return Some(BindingDefaults) from default_binding() to opt into the flexible binding system. Protocols that return None use the legacy listen_addr system.

User-provided values override protocol defaults.

Fields

mac_address: Option<String>

MAC address for Layer 2 protocols (e.g., ARP spoofing with specific MAC)

interface: Option<String>

Network interface for raw protocols (e.g., “lo”, “eth0”, “en0”)

host: Option<String>

Host address (IPv4, IPv6, or hostname) for socket-based protocols Examples: “127.0.0.1”, “0.0.0.0”, “::”, “localhost”

port: Option<u16>

Port number for socket-based protocols Use Some(0) for automatic port assignment

Implementations

impl BindingDefaults

pub fn port_based(default_host: &str, default_port: u16) -> Self

Create binding defaults for port-based protocols (TCP, UDP, HTTP, DNS, etc.)

Arguments

• default_host - Host to bind (e.g., “127.0.0.1”, “0.0.0.0”)
• default_port - Port to bind (use 0 for automatic assignment)

Example

// TCP: bind to loopback by default, auto-assign port
BindingDefaults::port_based("127.0.0.1", 0)

pub fn interface_based(default_interface: &str) -> Self

Create binding defaults for interface-based protocols (ICMP, ARP, DataLink, etc.)

Arguments

• default_interface - Interface to bind (e.g., “lo”, “eth0”)

Example

// ICMP: bind to loopback interface by default
BindingDefaults::interface_based("lo")

pub fn apply( &self, user_mac: Option<String>, user_interface: Option<String>, user_host: Option<String>, user_port: Option<u16>, ) -> (Option<String>, Option<String>, Option<String>, Option<u16>)

Apply user-provided values, falling back to protocol defaults

User values take precedence over defaults. Returns the final binding configuration with all fields resolved.

Arguments

• user_mac - User-provided MAC address (overrides default)
• user_interface - User-provided interface (overrides default)
• user_host - User-provided host (overrides default)
• user_port - User-provided port (overrides default)

Returns

Tuple of (final_mac, final_interface, final_host, final_port)

Trait Implementations

impl Clone for BindingDefaults

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BindingDefaults

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

Formats the value using the given formatter.