Enum IfaceSelector 

pub enum IfaceSelector {
    Ipv4(Ipv4Addr),
    Name(String),
}

How a user names a host interface on a command line or in an API call.

Parsed as an IPv4 literal first and taken as an operating-system interface name otherwise. The two spellings cannot collide: an interface name that parses as an IPv4 address does not exist on any platform we support.

Both spellings are needed. A Windows interface name is a GUID ({6394C55F-F630-4BC7-92D2-7AC320C73D1C}), which a user has no easy way to obtain, so IPv4 has to work; and an interface that carries no address yet can only be named, so the name has to work too. Before this existed viva-camctl accepted only the address and viva-service only the name, and a user who had discovered a camera with one tool could not stream it with the other (#109).

Variants

Ipv4(Ipv4Addr)

One of the interface’s own IPv4 addresses, e.g. 169.254.105.106.

Name(String)

The name the operating system gives the interface, e.g. en0.

Implementations

impl IfaceSelector

pub fn resolve(&self) -> Result<Iface>

Resolve the selector against the interfaces this host reports.

Delegates to Iface::from_ipv4 or Iface::from_system; the only thing added here is the failure message, which lists what we can actually see. That listing is the point rather than a nicety: the Windows GUID a user needs is not discoverable from the error it replaces, and Iface::list is already the library’s own view of the machine (#57).

Trait Implementations

impl Clone for IfaceSelector

fn clone(&self) -> IfaceSelector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IfaceSelector

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

Formats the value using the given formatter.

impl Display for IfaceSelector

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

Formats the value using the given formatter.

impl FromStr for IfaceSelector

type Err = Infallible

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 for IfaceSelector

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for IfaceSelector

impl StructuralPartialEq for IfaceSelector