Enum RealmBuilderFactoryRequest

pub enum RealmBuilderFactoryRequest {
    Create {
        pkg_dir_handle: ClientEnd<DirectoryMarker>,
        realm_server_end: ServerEnd<RealmMarker>,
        builder_server_end: ServerEnd<BuilderMarker>,
        responder: RealmBuilderFactoryCreateResponder,
    },
    CreateFromRelativeUrl {
        pkg_dir_handle: ClientEnd<DirectoryMarker>,
        relative_url: String,
        realm_server_end: ServerEnd<RealmMarker>,
        builder_server_end: ServerEnd<BuilderMarker>,
        responder: RealmBuilderFactoryCreateFromRelativeUrlResponder,
    },
}

This protocol can be used to instruct the Realm Builder Server to begin creating a new realm.

Variants

Create

Creates a new RealmBuilder. The client end of realm_server_end can be used to mutate the realm that is being constructed, by doing things such as adding new children to the realm or adding capability routes between them. The client end of builder_server_end is used to finalize the realm, after which point it can be launched in a collection.

pkg_dir_handle is a handle to the test package. The realm builder client typically passes a handle to its own /pkg directory, and bundles the other-component into the same package.

Fields

pkg_dir_handle: ClientEnd<DirectoryMarker>

realm_server_end: ServerEnd<RealmMarker>

builder_server_end: ServerEnd<BuilderMarker>

responder: RealmBuilderFactoryCreateResponder

CreateFromRelativeUrl

Identical to Create, but instead of the realm being empty by default it contains the contents of the manifest located in the test package at the path indicated by relative_url, which must be a fragment-only URL (for example, #meta/other-component.cm; see https://fuchsia.dev/fuchsia-src/reference/components/url#relative-fragment-only).

Fields

pkg_dir_handle: ClientEnd<DirectoryMarker>

relative_url: String

realm_server_end: ServerEnd<RealmMarker>

builder_server_end: ServerEnd<BuilderMarker>

responder: RealmBuilderFactoryCreateFromRelativeUrlResponder

Implementations

impl RealmBuilderFactoryRequest

pub fn into_create( self, ) -> Option<(ClientEnd<DirectoryMarker>, ServerEnd<RealmMarker>, ServerEnd<BuilderMarker>, RealmBuilderFactoryCreateResponder)>

pub fn into_create_from_relative_url( self, ) -> Option<(ClientEnd<DirectoryMarker>, String, ServerEnd<RealmMarker>, ServerEnd<BuilderMarker>, RealmBuilderFactoryCreateFromRelativeUrlResponder)>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for RealmBuilderFactoryRequest

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

Formats the value using the given formatter.