Struct fidl_fuchsia_virtualization::GuestLifecycleSynchronousProxy

pub struct GuestLifecycleSynchronousProxy { /* private fields */ }

Implementations

impl GuestLifecycleSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: Time ) -> Result<GuestLifecycleEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn create( &self, guest_config: GuestConfig, ___deadline: Time ) -> Result<GuestLifecycleCreateResult, Error>

Create a VMM configured with the provided config. This instantiates all devices and loads the kernel without starting the VCPU or device dispatch loops.

Possible errors: - ALREADY_RUNNING: A VMM instance is already running, and must be stopped before being recreated.

All other errors are related to VMM initialization.

pub fn bind(&self, guest: ServerEnd<GuestMarker>) -> Result<(), Error>

Binds to the Guest protocol for an initialized guest.

This operation must be called between Create and Stop, otherwise the provided channel will be immediately closed.

pub fn run(&self, ___deadline: Time) -> Result<GuestLifecycleRunResult, Error>

Start the primary VCPU and any dispatch loop. This will not return until the VMM stops running. On a clean shutdown (either guest or client initiated) this will return success.

Possible errors: - ALREADY_RUNING: The VMM has already been started. - NOT_CREATED: Run was called before the VMM was created. - CONTROLLER_FORCED_HALT: Stop was called on a running VMM. - VCPU_START_FAILURE: Failed to start the primary VCPU. - VCPU_RUNTIME_FAILURE: A VCPU encountered a fatal error while running the guest.

pub fn stop(&self, ___deadline: Time) -> Result<(), Error>

Stop a running VMM. Returns once the dispatch loops have stopped. After Stop returns, Create and then Run can be called again.

Trait Implementations

impl Debug for GuestLifecycleSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for GuestLifecycleSynchronousProxy

type Proxy = GuestLifecycleProxy

The async proxy for the same protocol.

type Protocol = GuestLifecycleMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.