Struct AskingNetworking 

pub(crate) struct AskingNetworking {
    pkg_cache_path: PathBuf,
    enable: OnceLock<Result<bool>>,
    capable: DynVirtualNetworking,
    unsupported: DynVirtualNetworking,
}

A custom implementation of the [virtual_net::VirtualNetwork] that asks users if they want to use networking features at runtime.

Fields

pkg_cache_path: PathBuf

enable: OnceLock<Result<bool>>

capable: DynVirtualNetworking

unsupported: DynVirtualNetworking

Implementations

impl AskingNetworking

pub(crate) fn new( pkg_cache_path: PathBuf, capable_networking: DynVirtualNetworking, ) -> Self

fn ask_user(&self, fn_name: &str) -> Result<bool>

fn save_in_cache(&self) -> Result<()>

Trait Implementations

impl Clone for AskingNetworking

fn clone(&self) -> AskingNetworking

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AskingNetworking

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

Formats the value using the given formatter.

impl VirtualNetworking for AskingNetworking

An implementation of virtual networking

fn bridge<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, network: &'life1 str, access_token: &'life2 str, security: StreamSecurity, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

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<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Disconnects from the remote network essentially unbridging it

fn dhcp_acquire<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<IpAddr>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn ip_add<'life0, 'async_trait>( &'life0 self, ip: IpAddr, prefix: u8, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn ip_remove<'life0, 'async_trait>( &'life0 self, ip: IpAddr, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn ip_clear<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clears all the assigned IP addresses for this interface

fn ip_list<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<IpCidr>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists all the IP addresses currently assigned to this interface

fn mac<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<[u8; 6]>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the hardware MAC address for this interface

fn gateway_set<'life0, 'async_trait>( &'life0 self, ip: IpAddr, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Adds a default gateway to the routing table

fn route_add<'life0, 'async_trait>( &'life0 self, cidr: IpCidr, via_router: IpAddr, preferred_until: Option<Duration>, expires_at: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Adds a specific route to the routing table

fn route_remove<'life0, 'async_trait>( &'life0 self, cidr: IpAddr, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Removes a routing rule from the routing table

fn route_clear<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clears the routing table for this interface

fn route_list<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<IpRoute>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn bind_raw<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn VirtualRawSocket + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn listen_tcp<'life0, 'async_trait>( &'life0 self, addr: SocketAddr, only_v6: bool, reuse_port: bool, reuse_addr: bool, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn VirtualTcpListener + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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<'life0, 'async_trait>( &'life0 self, addr: SocketAddr, reuse_port: bool, reuse_addr: bool, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn VirtualUdpSocket + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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<'life0, 'async_trait>( &'life0 self, addr: IpAddr, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn VirtualIcmpSocket + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn connect_tcp<'life0, 'async_trait>( &'life0 self, addr: SocketAddr, peer: SocketAddr, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn VirtualTcpSocket + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

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

fn resolve<'life0, 'life1, 'async_trait>( &'life0 self, host: &'life1 str, port: Option<u16>, dns_server: Option<IpAddr>, ) -> Pin<Box<dyn Future<Output = Result<Vec<IpAddr>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Performs DNS resolution for a specific hostname

fn bind_tcp<'life0, 'async_trait>( &'life0 self, addr: SocketAddr, only_v6: bool, reuse_port: bool, reuse_addr: bool, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn VirtualTcpBoundSocket + Sync>, NetworkError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Binds a TCP socket to a specific IP and port without immediately listening for connections or connecting to a peer.