Struct netemul::TestInterface

pub struct TestInterface<'a> { /* private fields */ }

A TestEndpoint that is installed in a realm’s Netstack.

Note that a TestInterface adds to the reference count of the underlying realm of its TestRealm. That is, a TestInterface that outlives the TestRealm it created is sufficient to keep the underlying realm alive.

Implementations

impl<'a> TestInterface<'a>

pub fn id(&self) -> u64

Gets the interface identifier.

pub fn endpoint(&self) -> &TestEndpoint<'a>

Returns the endpoint associated with the interface.

pub fn control(&self) -> &Control

Returns the interface’s control handle.

pub async fn get_authorization( &self ) -> Result<GrantForInterfaceAuthorization, Error>

Returns the authorization token for this interface.

pub fn connect_stack(&self) -> Result<StackProxy, Error>

Connects to fuchsia.net.stack in this interface’s realm.

pub async fn add_subnet_route(&self, subnet: Subnet) -> Result<(), Error>

Add a direct route from the interface to the given subnet.

pub async fn del_subnet_route(&self, subnet: Subnet) -> Result<(), Error>

Delete a direct route from the interface to the given subnet.

pub async fn add_default_route(&self, next_hop: IpAddress) -> Result<(), Error>

Add a default route through the given address.

pub async fn create_authenticated_global_route_set<I: FidlRouteIpExt + FidlRouteAdminIpExt>( &self ) -> Result<<I::RouteSetMarker as ProtocolMarker>::Proxy, Error>

Create a root route set authenticated to manage routes through this interface.

pub async fn get_addrs( &self, included_addresses: IncludedAddresses ) -> Result<Vec<Address>, Error>

Gets the interface’s addresses.

pub async fn get_interface_name(&self) -> Result<String, Error>

Gets the interface’s device name.

pub async fn get_device_class(&self) -> Result<DeviceClass, Error>

Gets the interface’s device class.

pub async fn mac(&self) -> MacAddress

Gets the interface’s MAC address.

pub fn get_interface_event_stream( &self ) -> Result<impl Stream<Item = Result<Event, Error>>, Error>

Gets a stream of interface events yielded by calling watch on a new watcher.

The returned watcher will only return assigned addresses.

pub async fn start_dhcp<D: DhcpClient>(&self) -> Result<(), Error>

Starts DHCP on this interface.

pub async fn stop_dhcp<D: DhcpClient>(&self) -> Result<(), Error>

Stops DHCP on this interface.

pub async fn add_address(&self, subnet: Subnet) -> Result<(), Error>

Adds an address, waiting until the address assignment state is ASSIGNED.

pub async fn add_address_and_subnet_route( &self, subnet: Subnet ) -> Result<(), Error>

Adds an address and a subnet route, waiting until the address assignment state is ASSIGNED.

pub async fn del_address_and_subnet_route( &self, addr_with_prefix: Subnet ) -> Result<bool, Error>

Removes an address and a subnet route.

pub async fn remove_ipv6_linklocal_addresses( &self ) -> Result<Vec<Address>, Error>

Removes all IPv6 LinkLocal addresses on the interface.

Useful to purge the interface of autogenerated SLAAC addresses.

pub async fn set_ipv6_forwarding_enabled( &self, enabled: bool ) -> Result<(), Error>

Enable/disable IPv6 forwarding on this interface.

pub async fn set_ipv4_forwarding_enabled( &self, enabled: bool ) -> Result<(), Error>

Enable/disable IPv4 forwarding on this interface.

pub async fn remove( self ) -> Result<(EndpointProxy, Option<DeviceControlProxy>), Error>

Consumes this TestInterface and removes the associated interface in the Netstack, returning the device lifetime-carrying channels.

pub fn remove_device(self) -> (Control, Option<DeviceControlProxy>)

Consumes this TestInterface and removes the underlying device. The Netstack will implicitly remove the interface and clients can expect to observe a PEER_CLOSED event on the returned control channel.

pub async fn wait_removal(self) -> Result<InterfaceRemovedReason, Error>

Waits for this interface to signal that it’s been removed.

pub async fn set_dad_transmits( &self, dad_transmits: u16 ) -> Result<Option<u16>, Error>

Sets the number of DAD transmits on this interface.

Returns the previous configuration value, if reported by the API.

Methods from Deref<Target = EndpointProxy>

pub fn take_event_stream(&self) -> EndpointEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn get_config(&self) -> QueryResponseFut<EndpointConfig>

pub fn get_name(&self) -> QueryResponseFut<String>

Gets endpoint name.

pub fn set_link_up(&self, up: bool) -> QueryResponseFut<()>

Sends link up or down signal

pub fn get_port(&self, port: ServerEnd<PortMarker>) -> Result<(), Error>

Connects to the underlying device port.

pub fn get_proxy_( &self, proxy: ServerEnd<DeviceProxy_Marker> ) -> Result<(), Error>

Gets a proxy to open requests with zircon ethernet device.

Trait Implementations

impl<'a> Debug for TestInterface<'a>

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

Formats the value using the given formatter.

impl<'a> Deref for TestInterface<'a>

type Target = EndpointProxy

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.