Struct InstanceRegistry 

pub struct InstanceRegistry { /* private fields */ }

Registry view tied to a specific guest instance.

Implementations

impl InstanceRegistry

pub fn load_mailbox( &mut self, mb: &'static GuestMailbox, ) -> Result<(), RegistryError>

Attach a mailbox used for guest async wake-ups.

Returns an error if the instance state is missing.

pub fn registrar(&self) -> InstanceRegistrar

Create a lightweight registrar for instance-scoped resources.

pub fn refresh_mailbox(&self, base: usize)

Refresh mailbox base pointers after guest memory growth.

pub fn close_mailbox(&self)

Close the mailbox to prevent further guest wake-ups.

pub fn set_memory_limit(&mut self, bytes: usize) -> Result<(), RegistryError>

Set a hard memory limit for this instance.

Returns an error if the instance state is missing.

pub fn insert<T: Send + 'static>( &mut self, entry: T, owner: Option<ResourceId>, kind: ResourceType, ) -> Result<usize, RegistryError>

Insert a resource entry and return its slot index.

pub fn insert_id(&mut self, id: ResourceId) -> Result<usize, RegistryError>

Insert a resource ID and return its slot index.

pub fn entry(&self, idx: usize) -> Option<ResourceId>

Retrieve the entry for the given slot.

pub fn with<T: 'static, R>( &self, idx: ResourceId, f: impl FnOnce(&mut T) -> R, ) -> Option<R>

Borrow a resource by table index and apply a closure.

pub fn insert_extension<T: Any + Send + Sync>( &mut self, value: T, ) -> Result<(), RegistryError>

Attach custom extension data to the instance.

Returns an error if the instance state is missing.

pub fn extension<T: Any + Send + Sync>(&self) -> Option<Arc<T>>

Borrow extension data by type.

pub fn remove<T: 'static>(&mut self, idx: usize) -> Option<T>

Remove an entry by slot index.

pub fn detach_slot(&mut self, idx: usize) -> Option<ResourceId>

Remove a slot entry without deleting the underlying resource.

pub fn waker(&self, task_id: usize) -> Option<Waker>

Produce a waker for the specified guest task if the mailbox is available.

pub fn mailbox(&self) -> Option<&'static GuestMailbox>

Access the guest mailbox backing async wake-ups.

pub fn registry(&self) -> &Registry

Get a reference to the global registry.

pub fn registry_arc(&self) -> Arc<Registry>

Clone the underlying global registry reference.

pub fn set_process_id( &mut self, process_id: ResourceId, ) -> Result<(), RegistryError>

Set the process identifier for this instance. Must be called before guest code can create resources.

Returns an error if the instance state is missing.

pub fn grant_session_resource( &self, session_slot: usize, capability: Capability, resource: ResourceId, ) -> Result<bool, KernelError>

Grant a resource capability to the specified session entry.

pub fn revoke_session_resource( &self, session_slot: usize, capability: Capability, resource: ResourceId, ) -> Result<Result<bool, SessionError>, KernelError>

Revoke a resource capability from the specified session entry.

pub fn insert_future( &mut self, state: Arc<FutureSharedState<GuestResult<Vec<u8>>>>, ) -> Result<usize, RegistryError>

Insert a guest future and return its handle.

pub fn remove_future( &mut self, handle: usize, ) -> Option<Arc<FutureSharedState<GuestResult<Vec<u8>>>>>

Remove a future handle, returning the shared state if present.

Trait Implementations

impl Drop for InstanceRegistry

fn drop(&mut self)

Executes the destructor for this type.