Struct optee_utee::object::ObjectHandle

pub struct ObjectHandle(/* private fields */);

An opaque handle on an object.

Implementations

impl ObjectHandle

pub fn from_raw(raw: TEE_ObjectHandle) -> Result<ObjectHandle>

pub fn handle(&self) -> TEE_ObjectHandle

pub fn forget(self)

Forget the inner handle to prevent a double-free, this function would be called when the inner handle is(or will be) freed externally.

Example:

// `external_handle` is a handle that is constructed and controlled
// externally.
// `handle` is valid, and will call TEE_CloseObject on
// `external_handle` when it is dropping, which is not allowed
// as the `external_handle` is externally controlled.
let mut handle = ObjectHandle::from_raw(external_handle)?;
// ... Some operation
// forget the inner handle, so it won't call TEE_CloseObject on
// `external_handle`
handle.forget();

Trait Implementations

impl Debug for ObjectHandle

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

Formats the value using the given formatter.

impl Drop for ObjectHandle

fn drop(&mut self)

Executes the destructor for this type.

impl GenericObject for ObjectHandle

fn handle(&self) -> TEE_ObjectHandle

Return the handle of an object.

fn info(&self) -> Result<ObjectInfo>

Return the characteristics of an object.

fn restrict_usage(&mut self, obj_usage: UsageFlag) -> Result<()>

Restrict the object usage flags of an object handle to contain at most the flags passed in the obj_usage parameter.

fn ref_attribute(&self, id: AttributeId, buffer: &mut [u8]) -> Result<usize>

Extract one buffer attribute from an object. The attribute is identified by the argument id.

fn value_attribute(&self, id: u32) -> Result<(u32, u32)>

Extract one value attribute from an object. The attribute is identified by the argument id.