Struct DriverContext 

#[non_exhaustive]
pub struct DriverContext {
    pub root_dispatcher: DispatcherRef<'static>,
    pub start_args: DriverStartArgs,
    pub incoming: Incoming,
}

The context arguments passed to the driver in its start arguments.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

root_dispatcher: DispatcherRef<'static>

A reference to the root [fdf::Dispatcher] for this driver.

start_args: DriverStartArgs

The original DriverStartArgs passed in as start arguments, minus any parts that were used to construct other elements of Self.

incoming: Incoming

The incoming namespace constructed from DriverStartArgs::incoming. Since producing this consumes the incoming namespace from Self::start_args, that will always be None.

Implementations

impl DriverContext

pub fn take_node(&mut self) -> Result<Node, Status>

Binds the node proxy client end from the start args into a [NodeProxy] that can be used to add child nodes. Dropping this proxy will result in the node being removed and the driver starting shutdown, so it should be bound and stored in your driver object in its crate::Driver::start method.

After calling this, DriverStartArgs::node in Self::start_args will be None.

Returns [Status::INVALID_ARGS] if the node client end is not present in the start arguments.

pub fn take_config<C: Config>(&mut self) -> Result<C, Status>

Returns the component config.

After calling this, DriverStartArgs::config in Self::start_args will be None.

Returns [Status::INVALID_ARGS] if the config is not present in the start arguments.

pub fn serve_outgoing<O: ServiceObjTrait>( &mut self, outgoing_fs: &mut ServiceFs<O>, ) -> Result<(), Status>

Serves the given [ServiceFs] on the node’s outgoing directory. This can only be called once, and after this the DriverStartArgs::outgoing_dir member will be None.

Logs an error and returns [Status::INVALID_ARGS] if the outgoing directory server end is not present in the start arguments, or [Status::INTERNAL] if serving the connection failed.

pub fn publish_inspect( &self, inspector: &Inspector, scope: ScopeHandle, ) -> Result<(), Status>

Spawns a server handling fuchsia.inspect.Tree requests and a handle to the fuchsia.inspect.Tree is published using fuchsia.inspect.InspectSink.

Whenever the client wishes to stop publishing Inspect, the Controller may be dropped.