Crate netstack_testing_common

Provides utilities for Netstack integration tests.

Modules

• constants
  Useful constants for tests.
• devices
  Utilities for interacting with devices during integration tests.
• dhcpv4
  Utilities for interacting with DHCPv4 client/server during integration tests.
• interfaces
  Provides utilities for using fuchsia.net.interfaces and fuchsia.net.interfaces.admin in Netstack integration tests.
• ndp
  Helpers for tests involving the Neighbor Discovery Protocol.
• nud
  Useful NUD functions for tests.
• packets
  Packet parsing helpers.
• ping
  Ping utilities.
• realms
  Provides utilities for test realms.

Constants

• ASYNC_EVENT_CHECK_INTERVAL
  The time to wait between two consecutive checks of an event.
• ASYNC_EVENT_NEGATIVE_CHECK_TIMEOUT
  Extra time to use when waiting for an async event to not occur.
• ASYNC_EVENT_POSITIVE_CHECK_TIMEOUT
  Extra time to use when waiting for an async event to occur.

Functions

• annotate
  Wraps fut so that it prints event_name and the caller’s location to stderr every interval until fut completes.
• get_child_component_event_matcher
  Gets an event matcher for component_moniker in realm.
• get_component_moniker
  Gets the moniker of a component in a test realm, relative to the root of the dynamic collection in which it is running.
• get_component_stopped_event_stream
  Gets a component event stream yielding component stopped events.
• get_deprecated_netstack2_inspect_data
  Read an Inspect hierarchy and filter it down to properties of interest from the diagnostics directory of Netstack2. For any other component, please use get_inspect_data, this function doesn’t apply to any other component and won’t work.
• get_inspect_data
  Gets inspect data in realm.
• get_inspect_property
  Like get_inspect_data but returns a single property matched by property_selector.
• pause_fake_clock
  Pauses the fake clock in the given realm.
• setup_network
  Sets up a realm with a network with no required services.
• setup_network_with
  Sets up a realm with required services and a network used for tests requiring manual packet inspection and transmission.
• sleep
  Asynchronously sleeps for specified secs seconds.
• try_all
  Returns true if the stream only yields true.
• try_any
  Returns true once the stream yields a true.
• wait_for_component_stopped
  Like wait_for_component_stopped_with_stream but retrieves an event stream for the caller.
• wait_for_component_stopped_with_stream
  Waits for a stopped event to be emitted for a component in a test realm.

Type Aliases

• Result
  An alias for Result<T, anyhow::Error>.