Struct Handle 

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

An owned and valid Zircon handle to a kernel object.

This type can be interconverted to and from more specific types. Those conversions are not enforced in the type system; attempting to use them will result in errors returned by the kernel. These conversions don’t change the underlying representation, but do change the type and what operations are available.

Lifecycle

This type closes the handle it owns when dropped.

Layout

Option<Handle> is guaranteed to have the same layout and bit patterns as zx_handle_t. Unlike many types in this crate it does not implement zerocopy traits because those are not appropriate for types with real Drop implementations.

Implementations

impl Handle

pub unsafe fn from_raw(raw: zx_handle_t) -> Self

Take exclusive ownership over a raw handle.

Safety

raw must be a valid handle present in the current handle table that will not be closed by another owner.

Panics

If ZX_HANDLE_INVALID is passed.

pub fn check_raw_valid(raw: zx_handle_t) -> Result<(), Status>

Wraps the zx_handle_check_valid syscall.

Note that this does not guarantee that the handle is safe to pass to Handle::from_raw in cases where another function may close the handle.

pub const fn raw_handle(&self) -> zx_handle_t

Returns the raw handle’s integer value.

pub const fn into_raw(self) -> zx_handle_t

Return the raw handle’s integer value without closing it when self is dropped.

pub fn replace(self, rights: Rights) -> Result<Self, Status>

Wraps the zx_handle_replace syscall.

Trait Implementations

impl Debug for Handle

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

Formats the value using the given formatter.

impl Drop for Handle

fn drop(&mut self)

Executes the destructor for this type.

impl Hash for Handle

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Handle

fn cmp(&self, other: &Handle) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Handle

fn eq(&self, other: &Handle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Handle

fn partial_cmp(&self, other: &Handle) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Handle

impl StructuralPartialEq for Handle