Struct RutabagaDescriptor

pub struct RutabagaDescriptor { /* private fields */ }

Wraps a RawDescriptor and safely closes it when self falls out of scope.

Implementations

impl SafeDescriptor

pub fn try_clone(&self) -> Result<SafeDescriptor, Error>

Clones this descriptor, internally creating a new descriptor. The new SafeDescriptor will share the same underlying count within the kernel.

Trait Implementations

impl AsRawDescriptor for SafeDescriptor

fn as_raw_descriptor(&self) -> i64

Returns the underlying raw descriptor.

impl Drop for SafeDescriptor

fn drop(&mut self)

Executes the destructor for this type.

impl From<File> for SafeDescriptor

fn from(f: File) -> SafeDescriptor

Converts to this type from the input type.

impl From<SafeDescriptor> for File

fn from(_s: SafeDescriptor) -> File

Converts to this type from the input type.

impl FromRawDescriptor for SafeDescriptor

unsafe fn from_raw_descriptor(descriptor: i64) -> Self

Safety

Safe only if the caller ensures nothing has access to the descriptor after passing it to from_raw_descriptor

impl IntoRawDescriptor for SafeDescriptor

fn into_raw_descriptor(self) -> i64

impl TryFrom<&dyn AsRawDescriptor> for SafeDescriptor

fn try_from(rd: &dyn AsRawDescriptor) -> Result<Self, Self::Error>

Clones the underlying descriptor (handle), internally creating a new descriptor.

WARNING: Windows does NOT support cloning/duplicating all types of handles. DO NOT use this function on IO completion ports, sockets, or pseudo-handles (except those from GetCurrentProcess or GetCurrentThread). See https://docs.microsoft.com/en-us/windows/win32/api/handleapi/nf-handleapi-duplicatehandle for further details.

TODO(b/191800567): this API has sharp edges on Windows. We should evaluate making some adjustments to smooth those edges.

type Error = Error

The type returned in the event of a conversion error.