Struct DeviceManagerProxy

pub struct DeviceManagerProxy { /* private fields */ }

Implementations

impl DeviceManagerProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.block.encrypted/DeviceManager.

pub fn take_event_stream(&self) -> DeviceManagerEventStream

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

Panics

Panics if the event stream was already taken.

pub fn format( &self, key: &[u8], slot: u8, ) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Formats the device, destroying any previously-secured data. A new data key is generated and wrapped with the provided key into key slot slot, Returns ZX_ERR_BAD_STATE if the device is not currently sealed. Returns ZX_OK on success.

pub fn unseal( &self, key: &[u8], slot: u8, ) -> QueryResponseFut<i32, DefaultFuchsiaResourceDialect>

Attempts to unseal the device by using the provided master key to unwrap the data key wrapped in the specified key slot. If the key provided was the correct key for this slot, then the device node responding to this protocol will create an unsealed zxcrypt device as a child of itself in the device tree before returning success. Returns ZX_ERR_INVALID_ARGS if slot is invalid. Returns ZX_ERR_BAD_STATE and keeps the device open if the device is already unsealed. Returns other errors if operations on the underlying block device return errors. Returns ZX_OK on success.

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

Seals the device, causing any previously-created child zxcrypt Device to be removed some time later. (Someday we’d like this to only return once the unsealed child device is removed, but that’s not straightforward today.) Returns ZX_ERR_BAD_STATE if the device is already sealed. Returns ZX_OK on success.

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

Shreds the device, permanently overwriting the keys that would allow Unseal()ing the device again in the future. This call does not impact the current sealed/unsealed state of the device – if currently unsealed, the device will remain in that state until Seal() is called or the device is unbound. Returns ZX_OK on success. Returns other errors if operations on the underlying block device return errors.

Trait Implementations

impl Clone for DeviceManagerProxy

fn clone(&self) -> DeviceManagerProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceManagerProxy

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

Formats the value using the given formatter.

impl DeviceManagerProxyInterface for DeviceManagerProxy

type FormatResponseFut = QueryResponseFut<i32>

type UnsealResponseFut = QueryResponseFut<i32>

type SealResponseFut = QueryResponseFut<i32>

type ShredResponseFut = QueryResponseFut<i32>

fn format(&self, key: &[u8], slot: u8) -> Self::FormatResponseFut

fn unseal(&self, key: &[u8], slot: u8) -> Self::UnsealResponseFut

fn seal(&self) -> Self::SealResponseFut

fn shred(&self) -> Self::ShredResponseFut

impl Proxy for DeviceManagerProxy

type Protocol = DeviceManagerMarker

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.