Struct HostShimBuffer 

pub struct HostShimBuffer { /* private fields */ }

Implementor of DeviceBuffer for compatibility tests and explicit host-resident fixtures - stores raw bytes on the host, identifies as the requesting backend.

This is not a production substitute for real device allocation. Real device backends override crate::backend::VyreBackend::allocate_device_buffer to return their own concrete buffer type wrapped in Box<dyn DeviceBuffer>.

Implementations

impl HostShimBuffer

pub fn allocate( backend_id: &'static str, byte_len: usize, ) -> Box<dyn DeviceBuffer>

Allocate a zero-filled host-resident buffer. The bytes live in process memory; backends that use this still pay the upload cost on every dispatch but the consumer-side API is the same as for true device buffers.

pub fn from_bytes( backend_id: &'static str, bytes: Vec<u8>, ) -> Box<dyn DeviceBuffer>

Allocate from existing bytes. The buffer takes ownership.

pub fn as_slice(&self) -> &[u8]

Borrow the underlying bytes. Only HostShimBuffer exposes this - real device buffers cannot be byte-borrowed without a download.

pub fn as_mut_slice(&mut self) -> &mut [u8]

Mutably borrow the underlying bytes. Only valid on host-shim buffers; real device buffers panic.

pub fn set_label(&mut self, label: impl Into<String>)

Attach a debug label after allocation.

Trait Implementations

impl Debug for HostShimBuffer

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

Formats the value using the given formatter.

impl DeviceBuffer for HostShimBuffer

fn backend_id(&self) -> &'static str

Stable backend identifier the buffer belongs to. Matches crate::backend::VyreBackend::id of the allocating backend.

fn byte_len(&self) -> usize

Size of the allocation in bytes. The kernel sees this as the declared BufferDecl::count * element_size.

fn debug_label(&self) -> Option<&str>

Optional human-readable label (debug surface only). Backends may return None when no label was set.

fn as_any(&self) -> &dyn Any

Erase to &dyn Any so callers can downcast without naming the concrete buffer type. Implementors return self.

fn as_any_mut(&mut self) -> &mut dyn Any

Mutable variant of Self::as_any. Implementors return self.