Struct CoherentHandle 

pub struct CoherentHandle<'a> { /* private fields */ }

An opaque DMA allocation without a kernel virtual mapping.

Unlike Coherent, a CoherentHandle does not provide CPU access to the allocated memory. The allocation is always performed with DMA_ATTR_NO_KERNEL_MAPPING, meaning no kernel virtual mapping is created for the buffer. The value returned by the C API as the CPU address is an opaque handle used only to free the allocation.

This is useful for buffers that are only ever accessed by hardware.

Invariants

• cpu_handle holds the opaque handle returned by dma_alloc_attrs with DMA_ATTR_NO_KERNEL_MAPPING set, and is only valid for passing back to dma_free_attrs.
• dma_addr is the corresponding bus address for device DMA.
• size is the allocation size in bytes as passed to dma_alloc_attrs.
• dma_attrs contains the attributes used for the allocation, always including DMA_ATTR_NO_KERNEL_MAPPING.

Implementations

impl<'a> CoherentHandle<'a>

pub fn alloc_with_attrs( dev: &'a Device<Bound>, size: usize, gfp_flags: Flags, dma_attrs: Attrs, ) -> Result<Self>

Allocates size bytes of coherent DMA memory without creating a kernel virtual mapping.

Additional DMA attributes may be passed via dma_attrs; DMA_ATTR_NO_KERNEL_MAPPING is always set implicitly.

Returns EINVAL if size is zero, ENOMEM if the allocation fails.

pub fn alloc( dev: &'a Device<Bound>, size: usize, gfp_flags: Flags, ) -> Result<Self>

Allocates size bytes of coherent DMA memory without creating a kernel virtual mapping.

pub fn dma_address(&self) -> DmaAddress

Returns the DMA address for this allocation.

This address can be programmed into device hardware for DMA access.

pub fn size(&self) -> usize

Returns the size in bytes of this allocation.

Trait Implementations

impl Drop for CoherentHandle<'_>

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.

impl Send for CoherentHandle<'_>

impl Sync for CoherentHandle<'_>