Struct DynamicDataSinkProxy

pub struct DynamicDataSinkProxy { /* private fields */ }

Implementations

impl DynamicDataSinkProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.paver/DynamicDataSink.

pub fn take_event_stream(&self) -> DynamicDataSinkEventStream

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

Panics

Panics if the event stream was already taken.

pub fn read_asset( &self, configuration: Configuration, asset: Asset, ) -> QueryResponseFut<DataSinkReadAssetResult, DefaultFuchsiaResourceDialect>

Reads the partition corresponding to configuration and asset into a vmo and returns it. The size field of the returned Buffer will be the size of just the asset, if it can be determined. Otherwise, it will be the size of the entire partition. The size and stream size of the vmo in the returned Buffer will always be the size of the entire partition.

pub fn write_asset( &self, configuration: Configuration, asset: Asset, payload: Buffer, ) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Writes partition corresponding to configuration and asset with data from payload. payload may need to be resized to the partition size, so the provided vmo must have been created with ZX_VMO_RESIZABLE or must be a child VMO that was created with ZX_VMO_CHILD_RESIZABLE. Will zero out rest of the partition if payload is smaller than the size of the partition being written.

Returns ZX_ERR_INVALID_ARGS if configuration specifies active configuration.

pub fn write_firmware( &self, configuration: Configuration, type_: &str, payload: Buffer, ) -> QueryResponseFut<WriteFirmwareResult, DefaultFuchsiaResourceDialect>

Writes firmware data from payload.

configuration represents the A/B/R configuration. For platforms that do not support firmware A/B/R, the parameter will be ignored by the underlying device-specific logic .

type is a device-specific string identifying the payload contents, used to select the proper paving logic. For example, a device with multiple bootloader stages might send them as separate calls to WriteFirmware(), differentiated by type. An empty string indicates the default type.

payload may need to be resized to the partition size, so the provided vmo must have been created with ZX_VMO_RESIZABLE or must be a child VMO that was created with ZX_VMO_CHILD_RESIZABLE.

pub fn read_firmware( &self, configuration: Configuration, type_: &str, ) -> QueryResponseFut<DataSinkReadFirmwareResult, DefaultFuchsiaResourceDialect>

Read firmware corresponding to configuration and type.

Parameter configuration and type are the same as WriteFirmware.

If ReadFirmware returns error, caller should assume that firmware image does not exist or is in a bad state, or firmware read is not defined for the product.

pub fn write_volumes( &self, payload: ClientEnd<PayloadStreamMarker>, ) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Writes FVM with data from streamed via payload. This potentially affects all configurations.

pub fn write_opaque_volume( &self, payload: Buffer, ) -> QueryResponseFut<DataSinkWriteOpaqueVolumeResult, DefaultFuchsiaResourceDialect>

Write a raw volume image to the device. The image will be passed as it is to the device partitioner backend to write. Therefore the format and write logic for the image is up to the product to define. It differs from WriteVolume(), which is specifically for writing the FVM sparse image, in that the paver will not perform any FVM related parsing or other operation of the image. Thus it is not dependent on the volume driver version and less susceptible to an outdated paver.

Returns ZX_ERR_NOT_SUPPORTED if the backend does not support opaque volume blobs.

pub fn write_sparse_volume( &self, payload: Buffer, ) -> QueryResponseFut<DataSinkWriteSparseVolumeResult, DefaultFuchsiaResourceDialect>

Writes an image in the Android Sparse format. Identical in behaviour to WriteOpaqueVolume, except the contents of payload are parsed as a sparse image and unpacked before being written to disk.

pub fn flush(&self) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Flush all previously buffered writes to persistent storage.

pub fn initialize_partition_tables( &self, ) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Initializes partitions on given block device.

Currently only supported on devices which don’t support fastboot (which is the preferred mechanism for device setup).

WARNING: This API will wipe the existing partitions and data loss may occur. Non-Fuchsia partitions may be preserved, although this is behaviour is board-specific.

pub fn wipe_partition_tables( &self, ) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Wipes all entries from the partition table of the specified block device. Currently only supported on devices with a GPT.

WARNING: This API may destructively remove non-fuchsia maintained partitions from the block device.

Trait Implementations

impl Clone for DynamicDataSinkProxy

fn clone(&self) -> DynamicDataSinkProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DynamicDataSinkProxy

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

Formats the value using the given formatter.

impl DynamicDataSinkProxyInterface for DynamicDataSinkProxy

type ReadAssetResponseFut = QueryResponseFut<Result<Buffer, i32>>

type WriteAssetResponseFut = QueryResponseFut<i32>

type WriteFirmwareResponseFut = QueryResponseFut<WriteFirmwareResult>

type ReadFirmwareResponseFut = QueryResponseFut<Result<Buffer, i32>>

type WriteVolumesResponseFut = QueryResponseFut<i32>

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

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

type FlushResponseFut = QueryResponseFut<i32>

type InitializePartitionTablesResponseFut = QueryResponseFut<i32>

type WipePartitionTablesResponseFut = QueryResponseFut<i32>

fn read_asset( &self, configuration: Configuration, asset: Asset, ) -> Self::ReadAssetResponseFut

fn write_asset( &self, configuration: Configuration, asset: Asset, payload: Buffer, ) -> Self::WriteAssetResponseFut

fn write_firmware( &self, configuration: Configuration, type_: &str, payload: Buffer, ) -> Self::WriteFirmwareResponseFut

fn read_firmware( &self, configuration: Configuration, type_: &str, ) -> Self::ReadFirmwareResponseFut

fn write_volumes( &self, payload: ClientEnd<PayloadStreamMarker>, ) -> Self::WriteVolumesResponseFut

fn write_opaque_volume( &self, payload: Buffer, ) -> Self::WriteOpaqueVolumeResponseFut

fn write_sparse_volume( &self, payload: Buffer, ) -> Self::WriteSparseVolumeResponseFut

fn flush(&self) -> Self::FlushResponseFut

fn initialize_partition_tables( &self, ) -> Self::InitializePartitionTablesResponseFut

fn wipe_partition_tables(&self) -> Self::WipePartitionTablesResponseFut

impl Proxy for DynamicDataSinkProxy

type Protocol = DynamicDataSinkMarker

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.