Google is committed to advancing racial equity for Black communities. See how.

fuchsia.netemul.environment

PROTOCOLS

ManagedEnvironment

Defined in fuchsia.netemul.environment/environment.fidl

Managed environment is made available on netemul runners. Typically this interface will be used by the root runner to setup the testing environment.

AddDevice

Exposes new virtual device device for all components within this environment

Request

NameType
device VirtualDevice

ConnectToService

Connects to a service named name provided by this environment.

Request

NameType
name string
req handle<channel>

CreateChildEnvironment

Creates a nested managed environment.

Request

NameType
child_env request<ManagedEnvironment>
options EnvironmentOptions

GetLauncher

Gets the managed launcher for the environment.

Request

NameType
launcher request<fuchsia.sys/Launcher>

RemoveDevice

Removes virtual device mounted at path (relative to /vdev)

Request

NameType
path string

STRUCTS

LaunchService

Defined in fuchsia.netemul.environment/environment.fidl

A single service to be launched in managed environment.

NameTypeDescriptionDefault
name string

Service name.

No default
url string

Service launch url (fuchsia component url).

No default
arguments vector<string>?

Service launch arguments

No default

VirtualDevice

Defined in fuchsia.netemul.environment/environment.fidl

A single virtual device to make available for child processes. Virtual devices are mounted on /vdev.

NameTypeDescriptionDefault
path string

Relative path to /vdev.

No default
device fuchsia.netemul.network/DeviceProxy

Virtual device server.

No default

TABLES

EnvironmentOptions

Defined in fuchsia.netemul.environment/environment.fidl

Options used to create environment.

OrdinalNameTypeDescription
1 name string

Environment name, for debugging purposes. If none provided, a random name will be generated.

2 services vector<LaunchService>

Services to register on environment. If none provided, no additional services will be registered. However, a ManagedEnvironment may still register some default services.

3 devices vector<VirtualDevice>

Devices to make available. If none provided, no devices will be made available.

4 inherit_parent_launch_services bool

Whether to inherit service launch options from parent environment. If none provided, assume false.

5 logger_options LoggerOptions

Logger Options. If none provided, log printing is disabled by default.

LoggerOptions

Defined in fuchsia.netemul.environment/environment.fidl

Logger specific options for a created environment

OrdinalNameTypeDescription
1 enabled bool

Enable printing logs.

2 klogs_enabled bool

Enable kernel logs (no effect if enabled is false).

3 filter_options fuchsia.logger/LogFilterOptions

LogFilter Options straight from fuchsia.logger.LogFilter. The LogFilterOptions will be passed directly to the Listen function of the fuchsia.logger.Log service without any modification. If none provided, assume null. See Listen of fuchsia.logger.Log for more information.

4 syslog_output bool

Use the parent environment's syslog for output, only enriching tags with environment names. If false or not provided, environment logs are printed to stdout.