Struct SharedMemory 

pub struct SharedMemory {
    state: Arc<RwLock<SharedMemoryState>>,
    id: String,
}

A shared memory object for inter-process communication

SharedMemory provides a memory region that can be mapped into multiple processes’ address spaces, allowing efficient data sharing without copying.

Fields

state: Arc<RwLock<SharedMemoryState>>

Shared state of the memory object

id: String

Unique identifier for debugging

Implementations

impl SharedMemory

pub fn new(size: usize, permissions: usize) -> Result<Self, &'static str>

Create a new shared memory object with the specified size and permissions

Arguments

• size - Size of the shared memory region in bytes (will be rounded up to page size)
• permissions - Access permissions (read/write/execute flags)

Returns

A new shared memory object, or an error if allocation fails

pub unsafe fn from_paddr(paddr: usize, size: usize, permissions: usize) -> Self

Create a shared memory object from an existing physical address

Arguments

• paddr - Physical address of the memory region
• size - Size of the memory region in bytes
• permissions - Access permissions

Returns

A new shared memory object wrapping the existing memory

Safety

The caller must ensure that the physical address is valid and the size is correct. The physical memory must remain valid for the lifetime of this object. This object will NOT free the memory on drop - the caller is responsible for managing the memory lifetime.

pub fn invalidate(&self)

Invalidate this shared memory object

This marks the shared memory as invalid, preventing new mappings. Existing mappings may continue to work but should be unmapped.

Trait Implementations

impl Drop for SharedMemory

fn drop(&mut self)

Executes the destructor for this type.

impl MemoryMappingOps for SharedMemory

fn get_mapping_info( &self, offset: usize, length: usize, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information for a region of the object

fn on_mapped( &self, _vaddr: usize, _paddr: usize, _length: usize, _offset: usize, )

Notification that a mapping has been created

fn on_unmapped(&self, _vaddr: usize, _length: usize)

Notification that a mapping has been removed

fn supports_mmap(&self) -> bool

Check if memory mapping is supported

fn mmap_owner_name(&self) -> String

Diagnostic helper: return a short owner name for logging

fn resolve_fault( &self, access: &AccessKind, map: &VirtualMemoryMap, ) -> Result<ResolveFaultResult, ResolveFaultError>

fn get_mapping_info_with( &self, offset: usize, length: usize, _is_shared: bool, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information with sharing intent.

impl SharedMemoryObject for SharedMemory

fn size(&self) -> usize

Get the size of the shared memory region in bytes

fn resize(&self, new_size: usize) -> Result<(), &'static str>

Resize the shared memory region (within capacity)

fn id(&self) -> String

Get a unique identifier for this shared memory object

fn is_valid(&self) -> bool

Check if the shared memory is still valid