Struct GuestCacheReader 

pub struct GuestCacheReader { /* private fields */ }

Read-only view of the guest’s heap-resident cap directory.

Implementations

impl GuestCacheReader

pub unsafe fn new(boot_info: &BootInfo) -> Result<Self, GuestCacheReaderError>

Construct a reader from a BootInfo block.

Safety

• boot_info.magic must equal [BootInfo::MAGIC].
• boot_info.directory_va must point at a GuestDirectory value living in the same address space (= the host’s process), allocated through the same FixedState seed as the guest’s DIRECTORY_HASHER_SEED.
• The reader must not outlive the sandbox that owns the directory.

pub fn len(&self) -> usize

Number of blob entries in the guest’s directory.

Safety

Implicit: see the type’s safety section. We declare this pub (not unsafe) on the strength of the new contract — once you have a GuestCacheReader, every read assumes the directory is quiescent.

pub fn is_empty(&self) -> bool

true iff the directory holds no blob entries.

pub fn get(&self, hash: &CapHash) -> Option<Arc<Cap>>

Look up a cap by content hash. Returns an Arc::clone of the guest’s Arc<Cap> if the blob is published; None otherwise.

The returned Arc keeps the guest’s Cap data alive across the lookup boundary — even if the guest later overwrites or removes the entry, the caller’s Arc stays valid (the data is freed only when the last Arc clone drops).

pub fn contains(&self, hash: &CapHash) -> bool

Whether a hash is present, without dereferencing the value.

Trait Implementations

impl Send for GuestCacheReader

impl Sync for GuestCacheReader