Trait wasmer_wasi::VirtualNetworking
source · pub trait VirtualNetworking: Debug + Send + Sync + 'static {
Show 21 methods
fn ws_connect(
&self,
url: &str
) -> Result<Box<dyn VirtualWebSocket + Sync + 'static, Global>, 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, Global>, 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, Global>, 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, Global>, NetworkError>;
fn bind_raw(
&self
) -> Result<Box<dyn VirtualRawSocket + Sync + 'static, Global>, NetworkError>;
fn listen_tcp(
&self,
addr: SocketAddr,
only_v6: bool,
reuse_port: bool,
reuse_addr: bool
) -> Result<Box<dyn VirtualTcpListener + Sync + 'static, Global>, NetworkError>;
fn bind_udp(
&self,
addr: SocketAddr,
reuse_port: bool,
reuse_addr: bool
) -> Result<Box<dyn VirtualUdpSocket + Sync + 'static, Global>, NetworkError>;
fn bind_icmp(
&self,
addr: IpAddr
) -> Result<Box<dyn VirtualIcmpSocket + Sync + 'static, Global>, NetworkError>;
fn connect_tcp(
&self,
addr: SocketAddr,
peer: SocketAddr,
timeout: Option<Duration>
) -> Result<Box<dyn VirtualTcpSocket + Sync + 'static, Global>, NetworkError>;
fn resolve(
&self,
host: &str,
port: Option<u16>,
dns_server: Option<IpAddr>
) -> Result<Vec<IpAddr, Global>, NetworkError>;
}
Expand description
An implementation of virtual networking
Required Methods§
sourcefn ws_connect(
&self,
url: &str
) -> Result<Box<dyn VirtualWebSocket + Sync + 'static, Global>, NetworkError>
fn ws_connect(
&self,
url: &str
) -> Result<Box<dyn VirtualWebSocket + Sync + 'static, Global>, 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)
sourcefn http_request(
&self,
url: &str,
method: &str,
headers: &str,
gzip: bool
) -> Result<SocketHttpRequest, NetworkError>
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)
sourcefn bridge(
&self,
network: &str,
access_token: &str,
security: StreamSecurity
) -> Result<(), NetworkError>
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)
sourcefn unbridge(&self) -> Result<(), NetworkError>
fn unbridge(&self) -> Result<(), NetworkError>
Disconnects from the remote network essentially unbridging it
sourcefn dhcp_acquire(&self) -> Result<Vec<IpAddr, Global>, NetworkError>
fn dhcp_acquire(&self) -> Result<Vec<IpAddr, Global>, NetworkError>
Acquires an IP address on the network and configures the routing tables
sourcefn ip_add(&self, ip: IpAddr, prefix: u8) -> Result<(), NetworkError>
fn ip_add(&self, ip: IpAddr, prefix: u8) -> Result<(), NetworkError>
Adds a static IP address to the interface with a netmask prefix
sourcefn ip_remove(&self, ip: IpAddr) -> Result<(), NetworkError>
fn ip_remove(&self, ip: IpAddr) -> Result<(), NetworkError>
Removes a static (or dynamic) IP address from the interface
sourcefn ip_clear(&self) -> Result<(), NetworkError>
fn ip_clear(&self) -> Result<(), NetworkError>
Clears all the assigned IP addresses for this interface
sourcefn ip_list(&self) -> Result<Vec<IpCidr, Global>, NetworkError>
fn ip_list(&self) -> Result<Vec<IpCidr, Global>, NetworkError>
Lists all the IP addresses currently assigned to this interface
sourcefn mac(&self) -> Result<[u8; 6], NetworkError>
fn mac(&self) -> Result<[u8; 6], NetworkError>
Returns the hardware MAC address for this interface
sourcefn gateway_set(&self, ip: IpAddr) -> Result<(), NetworkError>
fn gateway_set(&self, ip: IpAddr) -> Result<(), NetworkError>
Adds a default gateway to the routing table
sourcefn route_add(
&self,
cidr: IpCidr,
via_router: IpAddr,
preferred_until: Option<Duration>,
expires_at: Option<Duration>
) -> Result<(), NetworkError>
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
sourcefn route_remove(&self, cidr: IpAddr) -> Result<(), NetworkError>
fn route_remove(&self, cidr: IpAddr) -> Result<(), NetworkError>
Removes a routing rule from the routing table
sourcefn route_clear(&self) -> Result<(), NetworkError>
fn route_clear(&self) -> Result<(), NetworkError>
Clears the routing table for this interface
sourcefn route_list(&self) -> Result<Vec<IpRoute, Global>, NetworkError>
fn route_list(&self) -> Result<Vec<IpRoute, Global>, NetworkError>
Lists all the routes defined in the routing table for this interface
sourcefn bind_raw(
&self
) -> Result<Box<dyn VirtualRawSocket + Sync + 'static, Global>, NetworkError>
fn bind_raw(
&self
) -> Result<Box<dyn VirtualRawSocket + Sync + 'static, Global>, NetworkError>
Creates a low level socket that can read and write Ethernet packets directly to the interface
sourcefn listen_tcp(
&self,
addr: SocketAddr,
only_v6: bool,
reuse_port: bool,
reuse_addr: bool
) -> Result<Box<dyn VirtualTcpListener + Sync + 'static, Global>, NetworkError>
fn listen_tcp(
&self,
addr: SocketAddr,
only_v6: bool,
reuse_port: bool,
reuse_addr: bool
) -> Result<Box<dyn VirtualTcpListener + Sync + 'static, Global>, 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
sourcefn bind_udp(
&self,
addr: SocketAddr,
reuse_port: bool,
reuse_addr: bool
) -> Result<Box<dyn VirtualUdpSocket + Sync + 'static, Global>, NetworkError>
fn bind_udp(
&self,
addr: SocketAddr,
reuse_port: bool,
reuse_addr: bool
) -> Result<Box<dyn VirtualUdpSocket + Sync + 'static, Global>, 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
sourcefn bind_icmp(
&self,
addr: IpAddr
) -> Result<Box<dyn VirtualIcmpSocket + Sync + 'static, Global>, NetworkError>
fn bind_icmp(
&self,
addr: IpAddr
) -> Result<Box<dyn VirtualIcmpSocket + Sync + 'static, Global>, NetworkError>
Creates a socket that can be used to send and receive ICMP packets from a paritcular IP address
sourcefn connect_tcp(
&self,
addr: SocketAddr,
peer: SocketAddr,
timeout: Option<Duration>
) -> Result<Box<dyn VirtualTcpSocket + Sync + 'static, Global>, NetworkError>
fn connect_tcp(
&self,
addr: SocketAddr,
peer: SocketAddr,
timeout: Option<Duration>
) -> Result<Box<dyn VirtualTcpSocket + Sync + 'static, Global>, NetworkError>
Opens a TCP connection to a particular destination IP address and port