Struct MemoryArea 

pub struct MemoryArea<B: MappingBackend> { /* private fields */ }

A memory area represents a continuous range of virtual memory with the same flags.

The target physical memory frames are determined by MappingBackend and may not be contiguous.

Implementations

impl<B: MappingBackend> MemoryArea<B>

pub fn try_new( start: B::Addr, size: usize, flags: B::Flags, backend: B, ) -> MappingResult<Self>

Fallible counterpart of Self::new. New code that receives untrusted address/length pairs should use this constructor so an overflow is represented as a mapping error instead of a panic.

pub fn try_new_with_reported_flags( start: B::Addr, size: usize, flags: B::Flags, reported_flags: B::Flags, backend: B, ) -> MappingResult<Self>

Fallible constructor with separate operational and reported flags.

pub fn new(start: B::Addr, size: usize, flags: B::Flags, backend: B) -> Self

Creates a new memory area.

Panics

Panics if start + size overflows.

pub fn new_with_reported_flags( start: B::Addr, size: usize, flags: B::Flags, reported_flags: B::Flags, backend: B, ) -> Self

Creates a new memory area with separate backend and reported flags.

flags are used for page-table/backend operations. reported_flags are metadata exposed through introspection interfaces such as procfs.

Panics

Panics if start + size overflows.

pub fn new_with_permissions( start: B::Addr, size: usize, flags: B::Flags, reported_flags: B::Flags, max_flags: B::Flags, backend: B, ) -> Self

Creates an area with an explicit maximum permission envelope.

pub fn try_new_with_permissions( start: B::Addr, size: usize, flags: B::Flags, reported_flags: B::Flags, max_flags: B::Flags, backend: B, ) -> MappingResult<Self>

Fallible constructor with an explicit maximum permission envelope.

This is the constructor used at syscall boundaries. The older infallible constructors remain available for trusted boot-time mappings, but user supplied start + size pairs must not be allowed to wrap through AddrRange::from_start_size.

pub const fn va_range(&self) -> AddrRange<B::Addr>

Returns the virtual address range.

pub const fn flags(&self) -> B::Flags

Returns the memory flags, e.g., the permission bits.

pub const fn reported_flags(&self) -> B::Flags

Returns the permission flags reported to user-visible introspection.

pub const fn max_flags(&self) -> B::Flags

Returns the maximum permissions retained for this mapping.

pub const fn start(&self) -> B::Addr

Returns the start address of the memory area.

pub const fn end(&self) -> B::Addr

Returns the end address of the memory area.

pub fn size(&self) -> usize

Returns the size of the memory area.

pub const fn backend(&self) -> &B

Returns the mapping backend of the memory area.

Trait Implementations

impl<B: Clone + MappingBackend> Clone for MemoryArea<B>

where B::Addr: Clone, B::Flags: Clone,

fn clone(&self) -> MemoryArea<B>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B: MappingBackend> Debug for MemoryArea<B>

where B::Addr: Debug, B::Flags: Debug + Copy,

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

Formats the value using the given formatter.