Struct rutabaga_gfx::rutabaga_os::descriptor::SafeDescriptor

pub struct SafeDescriptor {
    pub(crate) descriptor: RawFd,
}

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

Fields

descriptor: RawFd

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 AsFd for SafeDescriptor

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.

impl AsRawDescriptor for SafeDescriptor

fn as_raw_descriptor(&self) -> RawFd

Returns the underlying raw descriptor.

impl AsRawFd for SafeDescriptor

fn as_raw_fd(&self) -> RawFd

Extracts the raw file 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 From<SharedMemory> for SafeDescriptor

fn from(sm: SharedMemory) -> SafeDescriptor

Converts to this type from the input type.

impl FromRawDescriptor for SafeDescriptor

unsafe fn from_raw_descriptor(descriptor: RawFd) -> 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) -> RawFd

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.

impl TryFrom<&dyn AsRawFd> for SafeDescriptor

type Error = Error

The type returned in the event of a conversion error.

fn try_from(fd: &dyn AsRawFd) -> Result<Self, Error>

Performs the conversion.