Struct PaverProxy 

pub struct PaverProxy { /* private fields */ }

Implementations

impl PaverProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.paver/Paver.

pub fn take_event_stream(&self) -> PaverEventStream

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

Panics

Panics if the event stream was already taken.

pub fn find_data_sink( &self, data_sink: ServerEnd<DataSinkMarker>, ) -> Result<(), Error>

Attempts to auto-discover the data sink where assets and volumes will get paved to. On devices with GPT, the partition must have a valid FVM partition in order for auto-discovery to find it. If multiple devices are found suitable, error is returned.

data_sink will be closed on error, with an epitaph provided on failure reason.

pub fn open_partition_io( &self, block_dir: ClientEnd<DirectoryMarker>, partition_io: ServerEnd<PartitionIoMarker>, ) -> Result<(), Error>

Opens a PartitionIo session backed by block devices in the caller-provided block_dir.

Under the capability-delegated permission model, the paver component does not hold ambient access to all system block partitions. Instead, the caller (such as system-updater or fastboot) is responsible for routing the required block device capabilities into its own namespace (for example, via a scoped /block or /block/ota directory exposed by fshost) and passing block_dir to the paver for the duration of the PartitionIo session.

block_dir is expected to follow the fshost /block directory layout (see https://fuchsia.dev/fuchsia-src/development/storage/storage-partition-routing): each entry <entry>/ is a subdirectory containing a fuchsia.storage.block.Block protocol node at <entry>/fuchsia.storage.block.Block.

partition_io will be closed on error, with an epitaph provided on failure reason.

pub fn find_partition_table_manager( &self, data_sink: ServerEnd<DynamicDataSinkMarker>, ) -> Result<(), Error>

Like FindDataSink, but the returned block device will be dynamic, supporting partition table manipulation.

data_sink will be closed on error, with an epitaph provided on failure reason.

pub fn find_boot_manager( &self, boot_manager: ServerEnd<BootManagerMarker>, ) -> Result<(), Error>

Attempts to auto-discover the boot manager.

boot_manager will be closed on error, with an epitaph provided on failure reason. ZX_ERR_NOT_SUPPORTED indicates lack of support and configuration A is always booted from.

pub fn find_sysconfig( &self, sysconfig: ServerEnd<SysconfigMarker>, ) -> Result<(), Error>

Find Sysconfig service.

Trait Implementations

impl Clone for PaverProxy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PaverProxy

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

Formats the value using the given formatter.

impl PaverProxyInterface for PaverProxy

fn find_data_sink( &self, data_sink: ServerEnd<DataSinkMarker>, ) -> Result<(), Error>

fn open_partition_io( &self, block_dir: ClientEnd<DirectoryMarker>, partition_io: ServerEnd<PartitionIoMarker>, ) -> Result<(), Error>

fn find_partition_table_manager( &self, data_sink: ServerEnd<DynamicDataSinkMarker>, ) -> Result<(), Error>

fn find_boot_manager( &self, boot_manager: ServerEnd<BootManagerMarker>, ) -> Result<(), Error>

fn find_sysconfig( &self, sysconfig: ServerEnd<SysconfigMarker>, ) -> Result<(), Error>

impl Proxy for PaverProxy

type Protocol = PaverMarker

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<'_, NullableHandle>>

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