Struct VmAddressRegion 

pub struct VmAddressRegion { /* private fields */ }

A contiguous region of the virtual address space.

Implementations

impl VmAddressRegion

pub fn create_sub_vmar( &self, offset: usize, size: usize, align_pow2: u8, vmar_flags: u32, name: &CStr, ) -> Result<RefPtr<VmAddressRegion>, Status>

Creates a subregion of this region.

pub fn create_vm_mapping( &self, mapping_offset: usize, size: usize, align_pow2: u8, vmar_flags: u32, vmo: RefPtr<VmObject>, vmo_offset: u64, arch_mmu_flags: ArchMmuFlags, name: &CStr, ) -> Result<MapResult, Status>

Creates a VmMapping within this region.

To avoid leaks, this should be paired with a call to VmMapping::destroy if desired; dropping MapResult::mapping will not destroy the mapping.

pub fn destroy(&self) -> Result<(), Status>

Destroys this region and recursively destroys child VMARs.

pub fn base(&self) -> VAddr

Returns the base address of this region.

pub fn size(&self) -> usize

Returns the size in bytes of this region.

pub fn flags(&self) -> u32

Returns the creation flags of this region.

pub fn name(&self) -> &CStr

Returns the name of this region.

pub fn has_parent(&self) -> bool

Returns true if this region has a parent region.

pub fn set_memory_priority( &self, priority: MemoryPriority, ) -> Result<(), Status>

Applies the given memory priority to this region and all subregions.

pub unsafe fn unmap( &self, base: VAddr, size: usize, op_children: VmAddressRegionOpChildren, ) -> Result<(), Status>

Unmaps a subset of the region of memory in the containing address space.

Safety

Caller must ensure the specified virtual address region to unmap is no longer used.

pub fn protect( &self, base: VAddr, size: usize, new_arch_mmu_flags: ArchMmuFlags, op_children: VmAddressRegionOpChildren, ) -> Result<(), Status>

Changes protections on a subset of the region of memory in the containing address space.

pub fn reserve_space( &self, name: &CStr, base: usize, size: usize, arch_mmu_flags: ArchMmuFlags, ) -> Result<(), Status>

Reserves a memory region within this VMAR without allocating physical pages.

Trait Implementations

impl HasRefCount for VmAddressRegion

fn ref_count(&self) -> &RefCounted

Returns a reference to the contained RefCounted field.

impl Recyclable for VmAddressRegion

unsafe fn recycle(ptr: NonNull<Self>)

Recycles the object.

fn allocate(_value: Self) -> Result<NonNull<Self>, AllocError>

Allocates a new instance of Self.

unsafe fn recycle_ffi(ptr: *mut c_void)

Helper for FFI functions to call recycle.