Struct ManagedRealmProxy

pub struct ManagedRealmProxy { /* private fields */ }

Implementations

impl ManagedRealmProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.netemul/ManagedRealm.

pub fn take_event_stream(&self) -> ManagedRealmEventStream

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

Panics

Panics if the event stream was already taken.

pub fn get_moniker( &self, ) -> QueryResponseFut<String, DefaultFuchsiaResourceDialect>

Returns the moniker of the root of the managed realm.

• response moniker the moniker of the root of the generated topology that contains this realm’s child components.

pub fn connect_to_protocol( &self, protocol_name: &str, child_name: Option<&str>, req: Channel, ) -> Result<(), Error>

Connects to a protocol named protocol_name provided by a child in this realm.

If child_name is not provided, connects to the first child offering protocol_name.

• request protocol_name the name of the protocol to connect to.
• request child_name the name of the child component that is exposing the requested protocol.
• request req a channel to be bound to an implementation of the protocol.

pub fn add_device( &self, path: &str, device: ClientEnd<DeviceProxy_Marker>, ) -> QueryResponseFut<ManagedRealmAddDeviceResult, DefaultFuchsiaResourceDialect>

Mounts new virtual device device on netemul’s devfs instance within this realm.

This devfs instance is available to components that have the [Capability.netemul_devfs] capability.

• request path relative path from devfs root to the virtual device to be added to the realm.
• request device virtual device server.

• error ZX_ERR_ALREADY_EXISTS if device.path is already in use.
• error ZX_ERR_INVALID_ARGS if an element of path exceeds [fuchsia.io/MAX_FILENAME] bytes in length.

pub fn remove_device( &self, path: &str, ) -> QueryResponseFut<ManagedRealmRemoveDeviceResult, DefaultFuchsiaResourceDialect>

Removes virtual device mounted at path.

• request path the path to virtual device to be removed from the realm, relative to devfs root.

• error ZX_ERR_NOT_FOUND if path is not currently bound to a device.
• error ZX_ERR_INVALID_ARGS if an element of path exceeds [fuchsia.io/MAX_FILENAME] bytes in length.

pub fn get_devfs(&self, devfs: ServerEnd<DirectoryMarker>) -> Result<(), Error>

Connects to netemul’s devfs instance for this realm.

• request devfs request handle to the devfs directory.

pub fn start_child_component( &self, child_name: &str, ) -> QueryResponseFut<ManagedRealmStartChildComponentResult, DefaultFuchsiaResourceDialect>

Starts the specified child component in this realm. Starting an already running child component is a no-op and returns success.

• request child_name the name of the child component to be started.

• error ZX_ERR_NOT_FOUND if child_name is not a child component in this realm.
• error ZX_ERR_INVALID_ARGS if child_name cannot be composed into a well-formed moniker.
• error ZX_ERR_INTERNAL if the call to the service dependency fails.

pub fn stop_child_component( &self, child_name: &str, ) -> QueryResponseFut<ManagedRealmStopChildComponentResult, DefaultFuchsiaResourceDialect>

Stops the specified child component in this realm. Stopping an already stopped child component is a no-op and returns success.

• request child_name the name of the child component to be stopped.

• error ZX_ERR_NOT_FOUND if child_name is not a child component in this realm.
• error ZX_ERR_INVALID_ARGS if child_name cannot be composed into a well-formed moniker.
• error ZX_ERR_INTERNAL if the call to the service dependency fails.

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

Request that the managed realm shut down.

The realm will send an OnShutdown event when shutdown is complete and before closing the channel.

pub fn open_diagnostics_directory( &self, child_name: &str, directory: ServerEnd<DirectoryMarker>, ) -> Result<(), Error>

Opens the diagnostics directory exposed by the component child_name.

Trait Implementations

impl Clone for ManagedRealmProxy

fn clone(&self) -> ManagedRealmProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ManagedRealmProxy

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

Formats the value using the given formatter.

impl ManagedRealmProxyInterface for ManagedRealmProxy

type GetMonikerResponseFut = QueryResponseFut<String>

type AddDeviceResponseFut = QueryResponseFut<Result<(), i32>>

type RemoveDeviceResponseFut = QueryResponseFut<Result<(), i32>>

type StartChildComponentResponseFut = QueryResponseFut<Result<(), i32>>

type StopChildComponentResponseFut = QueryResponseFut<Result<(), i32>>

fn get_moniker(&self) -> Self::GetMonikerResponseFut

fn connect_to_protocol( &self, protocol_name: &str, child_name: Option<&str>, req: Channel, ) -> Result<(), Error>

fn add_device( &self, path: &str, device: ClientEnd<DeviceProxy_Marker>, ) -> Self::AddDeviceResponseFut

fn remove_device(&self, path: &str) -> Self::RemoveDeviceResponseFut

fn get_devfs(&self, devfs: ServerEnd<DirectoryMarker>) -> Result<(), Error>

fn start_child_component( &self, child_name: &str, ) -> Self::StartChildComponentResponseFut

fn stop_child_component( &self, child_name: &str, ) -> Self::StopChildComponentResponseFut

fn shutdown(&self) -> Result<(), Error>

fn open_diagnostics_directory( &self, child_name: &str, directory: ServerEnd<DirectoryMarker>, ) -> Result<(), Error>

impl Proxy for ManagedRealmProxy

type Protocol = ManagedRealmMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.