Skip to main content

AddressSpace

Struct AddressSpace 

Source
pub struct AddressSpace { /* private fields */ }
Expand description

Tracked guest VA ranges for one process (borrowed images + owned mmaps).

Independent of the active trap slot: build and test locally, then install_active before jumping to guest code.

[check_snap] is an immutable Arc rebuilt on mutations so concurrent check_range can walk regions without holding the active RwLock.

Implementations§

Source§

impl AddressSpace

Source

pub fn new() -> Self

Empty address space (no tracked regions).

Source

pub fn is_active(&self) -> bool

True when at least one region is registered.

Source

pub fn clear(&mut self)

Clears all regions. Owned mappings are munmap’d; borrowed ones are not.

Source

pub fn register_borrowed(&mut self, region: &MappedRegion)

Registers a borrowed region (image / stack). Does not take ownership.

Source

pub fn register_owned( &mut self, guest_addr: u64, ptr: *mut u8, len: usize, prot: u32, )

Registers an owned mapping created by a guest mmap.

Source

pub fn check_range(&self, addr: u64, len: usize, need_write: bool) -> bool

Validates that [addr, addr+len) lies in a registered region with the requested access. When empty (unit tests without maps), returns true so pure dispatch tests do not need a full map setup.

Source

pub fn find_covering(&self, addr: u64, len: usize) -> Option<RegRegionSnapshot>

Finds the region that fully contains [addr, addr+len), if any.

Source

pub fn update_prot(&mut self, addr: u64, len: usize, prot: u32) -> bool

Updates protection bits on the region covering addr.

Source

pub fn remove_range(&mut self, addr: u64, len: usize) -> RemoveOutcome

Removes and optionally unmaps an owned region that fully covers the range.

Borrowed regions are removed from tracking without munmap.

Trait Implementations§

Source§

impl Debug for AddressSpace

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for AddressSpace

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Drop for AddressSpace

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

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. Read more
Source§

impl Sync for AddressSpace

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more