Struct CapHandle 

pub struct CapHandle { /* private fields */ }

A client-side capability handle.

Cloning a handle adds a reference; dropping the last handle notifies the provider (automatic lifetime, RPROPOSAL §3).

Implementations

impl CapHandle

pub fn new(control: Rc<dyn CapControl>, id: CapId) -> Self

Wrap a minted capability.

pub fn borrowed(control: Rc<dyn CapControl>, id: CapId) -> Self

A non-owning handle (used when reconstructing a handle from a transfer).

pub fn id(&self) -> CapId

pub fn into_id(self) -> CapId

Surrender this handle without releasing its reference.

Used when a reference moves (channel transfer): the receiver becomes responsible for the reference the sender held.

Trait Implementations

impl Clone for CapHandle

fn clone(&self) -> Self

Cloning an owning handle retains the capability: the kernel increments the reference count and both handles must drop before the provider is notified. Cloning a borrowed handle stays borrowed — it never retained a reference, so it must not create one.

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

Performs copy-assignment from source.

impl Debug for CapHandle

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

Formats the value using the given formatter.

impl Drop for CapHandle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.