Trait MiscDevice

pub trait MiscDevice {
    type Ptr: ForeignOwnable + Send + Sync;

    const USE_VTABLE_ATTR: ();
    const HAS_OPEN: bool = false;
    const HAS_RELEASE: bool = false;
    const HAS_IOCTL: bool = false;
    const HAS_COMPAT_IOCTL: bool = false;

    // Required method
    fn open() -> Result<Self::Ptr>;

    // Provided methods
    fn release(device: Self::Ptr) { ... }
    fn ioctl(
        _device: <Self::Ptr as ForeignOwnable>::Borrowed<'_>,
        _cmd: u32,
        _arg: usize,
    ) -> Result<isize> { ... }
    fn compat_ioctl(
        _device: <Self::Ptr as ForeignOwnable>::Borrowed<'_>,
        _cmd: u32,
        _arg: usize,
    ) -> Result<isize> { ... }
}

Trait implemented by the private data of an open misc device.

Required Associated Constants

const USE_VTABLE_ATTR: ()

A marker to prevent implementors from forgetting to use #[vtable] attribute when implementing this trait.

Provided Associated Constants

const HAS_OPEN: bool = false

Indicates if the open method is overridden by the implementor.

const HAS_RELEASE: bool = false

Indicates if the release method is overridden by the implementor.

const HAS_IOCTL: bool = false

Indicates if the ioctl method is overridden by the implementor.

const HAS_COMPAT_IOCTL: bool = false

Indicates if the compat_ioctl method is overridden by the implementor.

Required Associated Types

type Ptr: ForeignOwnable + Send + Sync

What kind of pointer should Self be wrapped in.

Required Methods

fn open() -> Result<Self::Ptr>

Called when the misc device is opened.

The returned pointer will be stored as the private data for the file.

Provided Methods

fn release(device: Self::Ptr)

Called when the misc device is released.

fn ioctl( _device: <Self::Ptr as ForeignOwnable>::Borrowed<'_>, _cmd: u32, _arg: usize, ) -> Result<isize>

Handler for ioctls.

The cmd argument is usually manipulated using the utilties in kernel::ioctl.

fn compat_ioctl( _device: <Self::Ptr as ForeignOwnable>::Borrowed<'_>, _cmd: u32, _arg: usize, ) -> Result<isize>

Handler for ioctls.

Used for 32-bit userspace on 64-bit platforms.

This method is optional and only needs to be provided if the ioctl relies on structures that have different layout on 32-bit and 64-bit userspace. If no implementation is provided, then compat_ptr_ioctl will be used instead.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors