Enum netidx::publisher::BindCfg

pub enum BindCfg {
    Match {
        addr: IpAddr,
        netmask: IpAddr,
    },
    Exact(SocketAddr),
}

Control how the publisher picks a bind address. The address we give to the resolver server must be uniquely routable back to us, otherwise clients will not be able to subscribe. In the furtherance of this goal there are a number of address rules to follow,

• no unspecified (0.0.0.0)
• no broadcast (255.255.255.255)
• no multicast addresses (224.0.0.0/8)
• no link local addresses (169.254.0.0/16)
• loopback (127.0.0.1, or ::1) is only allowed if all the resolvers are also loopback
• private addresses (192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12) are only allowed if all the resolvers are also using private addresses.

As well as the above rules we will enumerate all the network interface addresses present at startup time and check that the specified bind address (or specification in case of Addr) matches exactly 1 of them.

Variants

Match

Bind to the interface who’s address matches addr when masked with netmask, e.g.

192.168.0.0/16

will match interfaces with addresses 192.168.1.1, 192.168.10.234, … etc,

192.168.0.0/24

will match interfaces with addresses 192.168.0.[1-254]

Examples

use netidx::publisher::BindCfg;
"ffff:1c00:2700:3c00::/64".parse::<BindCfg>().unwrap();
"127.0.0.1/32".parse::<BindCfg>().unwrap();
"192.168.2.0/24".parse::<BindCfg>().unwrap();

Fields of Match

addr: IpAddrnetmask: IpAddr

Exact(SocketAddr)

Bind to the specifed SocketAddr, error if it is in use. If you want to OS to pick a port for you, use Exact with port 0. The ip address you specify must obey all the rules, and must be the ip address of one of the network interfaces present on the machine at the time of publisher creation.

Examples

use netidx::publisher::BindCfg;
"[ffff:1c00:2700:3c00::]:1234".parse::<BindCfg>().unwrap();
"192.168.0.1:1234".parse::<BindCfg>().unwrap();

Trait Implementations

impl Clone for BindCfg

fn clone(&self) -> BindCfg

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for BindCfg

impl Debug for BindCfg

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

Formats the value using the given formatter.

impl Eq for BindCfg

impl FromStr for BindCfg

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq<BindCfg> for BindCfg

fn eq(&self, other: &BindCfg) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &BindCfg) -> bool

This method tests for !=.

impl StructuralEq for BindCfg

impl StructuralPartialEq for BindCfg