Trait VirtualNetworking

pub trait VirtualNetworking:
    Debug
    + Send
    + Sync
    + 'static {
    // Required methods
    fn ws_connect(
        &self,
        url: &str,
    ) -> Result<Box<dyn VirtualWebSocket + Sync>, NetworkError>;
    fn http_request(
        &self,
        url: &str,
        method: &str,
        headers: &str,
        gzip: bool,
    ) -> Result<SocketHttpRequest, NetworkError>;
    fn bridge(
        &self,
        network: &str,
        access_token: &str,
        security: StreamSecurity,
    ) -> Result<(), NetworkError>;
    fn unbridge(&self) -> Result<(), NetworkError>;
    fn dhcp_acquire(&self) -> Result<Vec<IpAddr>, NetworkError>;
    fn ip_add(&self, ip: IpAddr, prefix: u8) -> Result<(), NetworkError>;
    fn ip_remove(&self, ip: IpAddr) -> Result<(), NetworkError>;
    fn ip_clear(&self) -> Result<(), NetworkError>;
    fn ip_list(&self) -> Result<Vec<IpCidr>, NetworkError>;
    fn mac(&self) -> Result<[u8; 6], NetworkError>;
    fn gateway_set(&self, ip: IpAddr) -> Result<(), NetworkError>;
    fn route_add(
        &self,
        cidr: IpCidr,
        via_router: IpAddr,
        preferred_until: Option<Duration>,
        expires_at: Option<Duration>,
    ) -> Result<(), NetworkError>;
    fn route_remove(&self, cidr: IpAddr) -> Result<(), NetworkError>;
    fn route_clear(&self) -> Result<(), NetworkError>;
    fn route_list(&self) -> Result<Vec<IpRoute>, NetworkError>;
    fn bind_raw(&self) -> Result<Box<dyn VirtualRawSocket + Sync>, NetworkError>;
    fn listen_tcp(
        &self,
        addr: SocketAddr,
        only_v6: bool,
        reuse_port: bool,
        reuse_addr: bool,
    ) -> Result<Box<dyn VirtualTcpListener + Sync>, NetworkError>;
    fn bind_udp(
        &self,
        addr: SocketAddr,
        reuse_port: bool,
        reuse_addr: bool,
    ) -> Result<Box<dyn VirtualUdpSocket + Sync>, NetworkError>;
    fn bind_icmp(
        &self,
        addr: IpAddr,
    ) -> Result<Box<dyn VirtualIcmpSocket + Sync>, NetworkError>;
    fn connect_tcp(
        &self,
        addr: SocketAddr,
        peer: SocketAddr,
        timeout: Option<Duration>,
    ) -> Result<Box<dyn VirtualTcpSocket + Sync>, NetworkError>;
    fn resolve(
        &self,
        host: &str,
        port: Option<u16>,
        dns_server: Option<IpAddr>,
    ) -> Result<Vec<IpAddr>, NetworkError>;
}

An implementation of virtual networking

Required Methods

fn ws_connect( &self, url: &str, ) -> Result<Box<dyn VirtualWebSocket + Sync>, NetworkError>

Establishes a web socket connection (note: this does not use the virtual sockets and is standalone functionality that works without the network being connected)

fn http_request( &self, url: &str, method: &str, headers: &str, gzip: bool, ) -> Result<SocketHttpRequest, NetworkError>

Makes a HTTP request to a remote web resource The headers are separated by line breaks (note: this does not use the virtual sockets and is standalone functionality that works without the network being connected)

fn bridge( &self, network: &str, access_token: &str, security: StreamSecurity, ) -> Result<(), NetworkError>

Bridges this local network with a remote network, which is required in order to make lower level networking calls (such as UDP/TCP)

fn unbridge(&self) -> Result<(), NetworkError>

Disconnects from the remote network essentially unbridging it

fn dhcp_acquire(&self) -> Result<Vec<IpAddr>, NetworkError>

Acquires an IP address on the network and configures the routing tables

fn ip_add(&self, ip: IpAddr, prefix: u8) -> Result<(), NetworkError>

Adds a static IP address to the interface with a netmask prefix

fn ip_remove(&self, ip: IpAddr) -> Result<(), NetworkError>

Removes a static (or dynamic) IP address from the interface

fn ip_clear(&self) -> Result<(), NetworkError>

Clears all the assigned IP addresses for this interface

fn ip_list(&self) -> Result<Vec<IpCidr>, NetworkError>

Lists all the IP addresses currently assigned to this interface

fn mac(&self) -> Result<[u8; 6], NetworkError>

Returns the hardware MAC address for this interface

fn gateway_set(&self, ip: IpAddr) -> Result<(), NetworkError>

Adds a default gateway to the routing table

fn route_add( &self, cidr: IpCidr, via_router: IpAddr, preferred_until: Option<Duration>, expires_at: Option<Duration>, ) -> Result<(), NetworkError>

Adds a specific route to the routing table

fn route_remove(&self, cidr: IpAddr) -> Result<(), NetworkError>

Removes a routing rule from the routing table

fn route_clear(&self) -> Result<(), NetworkError>

Clears the routing table for this interface

fn route_list(&self) -> Result<Vec<IpRoute>, NetworkError>

Lists all the routes defined in the routing table for this interface

fn bind_raw(&self) -> Result<Box<dyn VirtualRawSocket + Sync>, NetworkError>

Creates a low level socket that can read and write Ethernet packets directly to the interface

fn listen_tcp( &self, addr: SocketAddr, only_v6: bool, reuse_port: bool, reuse_addr: bool, ) -> Result<Box<dyn VirtualTcpListener + Sync>, NetworkError>

Lists for TCP connections on a specific IP and Port combination Multiple servers (processes or threads) can bind to the same port if they each set the reuse-port and-or reuse-addr flags

fn bind_udp( &self, addr: SocketAddr, reuse_port: bool, reuse_addr: bool, ) -> Result<Box<dyn VirtualUdpSocket + Sync>, NetworkError>

Opens a UDP socket that listens on a specific IP and Port combination Multiple servers (processes or threads) can bind to the same port if they each set the reuse-port and-or reuse-addr flags

fn bind_icmp( &self, addr: IpAddr, ) -> Result<Box<dyn VirtualIcmpSocket + Sync>, NetworkError>

Creates a socket that can be used to send and receive ICMP packets from a paritcular IP address

fn connect_tcp( &self, addr: SocketAddr, peer: SocketAddr, timeout: Option<Duration>, ) -> Result<Box<dyn VirtualTcpSocket + Sync>, NetworkError>

Opens a TCP connection to a particular destination IP address and port

fn resolve( &self, host: &str, port: Option<u16>, dns_server: Option<IpAddr>, ) -> Result<Vec<IpAddr>, NetworkError>

Performs DNS resolution for a specific hostname

Implementations on Foreign Types

impl VirtualNetworking for LocalNetworking

fn ws_connect( &self, url: &str, ) -> Result<Box<dyn VirtualWebSocket + Sync>, NetworkError>

fn http_request( &self, url: &str, method: &str, headers: &str, gzip: bool, ) -> Result<SocketHttpRequest, NetworkError>

fn bridge( &self, network: &str, access_token: &str, security: StreamSecurity, ) -> Result<(), NetworkError>

fn unbridge(&self) -> Result<(), NetworkError>

fn dhcp_acquire(&self) -> Result<Vec<IpAddr>, NetworkError>

fn ip_add(&self, ip: IpAddr, prefix: u8) -> Result<(), NetworkError>

fn ip_remove(&self, ip: IpAddr) -> Result<(), NetworkError>

fn ip_clear(&self) -> Result<(), NetworkError>

fn ip_list(&self) -> Result<Vec<IpCidr>, NetworkError>

fn mac(&self) -> Result<[u8; 6], NetworkError>

fn gateway_set(&self, ip: IpAddr) -> Result<(), NetworkError>

fn route_add( &self, cidr: IpCidr, via_router: IpAddr, preferred_until: Option<Duration>, expires_at: Option<Duration>, ) -> Result<(), NetworkError>

fn route_remove(&self, cidr: IpAddr) -> Result<(), NetworkError>

fn route_clear(&self) -> Result<(), NetworkError>

fn route_list(&self) -> Result<Vec<IpRoute>, NetworkError>

fn bind_raw(&self) -> Result<Box<dyn VirtualRawSocket + Sync>, NetworkError>

fn listen_tcp( &self, addr: SocketAddr, only_v6: bool, reuse_port: bool, reuse_addr: bool, ) -> Result<Box<dyn VirtualTcpListener + Sync>, NetworkError>

fn bind_udp( &self, addr: SocketAddr, _reuse_port: bool, _reuse_addr: bool, ) -> Result<Box<dyn VirtualUdpSocket + Sync>, NetworkError>

fn bind_icmp( &self, addr: IpAddr, ) -> Result<Box<dyn VirtualIcmpSocket + Sync>, NetworkError>

fn connect_tcp( &self, _addr: SocketAddr, peer: SocketAddr, timeout: Option<Duration>, ) -> Result<Box<dyn VirtualTcpSocket + Sync>, NetworkError>

fn resolve( &self, host: &str, port: Option<u16>, dns_server: Option<IpAddr>, ) -> Result<Vec<IpAddr>, NetworkError>

Implementors

impl VirtualNetworking for UnsupportedVirtualNetworking