Struct DeviceProxy 

pub struct DeviceProxy { /* private fields */ }

Implementations

impl DeviceProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.inlineencryption/Device.

pub fn take_event_stream(&self) -> DeviceEventStream

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

Panics

Panics if the event stream was already taken.

pub fn program_key( &self, wrapped_key: &[u8], data_unit_size: u32, ) -> QueryResponseFut<DeviceProgramKeyResult, DefaultFuchsiaResourceDialect>

Programs the ephemerally wrapped wrapped_key into the inline encryption hardware in the next available slot. All slots programmed via the connection this method is called on will be evicted once the connection is dropped. It is not possible to evict individual keys (not for any technical reasons; a need for this has not yet arisen). wrapped_key must be a key wrapped by the inline encryption hardware (in the same session/boot) via a separate mechanism to this protocol.

Returns

• ZX_ERR_NO_RESOURCES if there are no available key slots.
• ZX_ERR_INVALID_ARGS if wrapped_key is not the expected size or if the wrapped_key fails authentication (e.g. wrapped_key is from a previous boot).
• ZX_ERR_TIMED_OUT if the operation times out.
• ZX_ERR_INTERNAL if the operation failed for any other reason.

pub fn derive_raw_secret( &self, wrapped_key: &[u8], ) -> QueryResponseFut<DeviceDeriveRawSecretResult, DefaultFuchsiaResourceDialect>

Derives a raw software secret from the ephemerally wrapped wrapped_key. wrapped_key must be a key wrapped by the inline encryption hardware (in the same session/boot) via a separate mechanism to this protocol. The returned secret can be used for non-inline cryptographic operations e.g. it can be used for encrypting filesystem metadata not covered by inline encryption. Returns

• ZX_ERR_INVALID_ARGS if wrapped_key is not the expected size or if the wrapped_key fails authentication (e.g. wrapped_key is from a previous boot).
• ZX_ERR_TIMED_OUT if the operation times out.
• ZX_ERR_INTERNAL if the operation failed for any other reason.

Trait Implementations

impl Clone for DeviceProxy

fn clone(&self) -> DeviceProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceProxy

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

Formats the value using the given formatter.

impl DeviceProxyInterface for DeviceProxy

type ProgramKeyResponseFut = QueryResponseFut<Result<u8, i32>>

type DeriveRawSecretResponseFut = QueryResponseFut<Result<Vec<u8>, i32>>

fn program_key( &self, wrapped_key: &[u8], data_unit_size: u32, ) -> Self::ProgramKeyResponseFut

fn derive_raw_secret( &self, wrapped_key: &[u8], ) -> Self::DeriveRawSecretResponseFut

impl Proxy for DeviceProxy

type Protocol = DeviceMarker

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.