Struct HandleTable

pub struct HandleTable {
    handles: [Option<KernelObject>; 1024],
    metadata: [Option<HandleMetadata>; 1024],
    free_handles: Vec<Handle>,
}

Fields

handles: [Option<KernelObject>; 1024]

Fixed-size handle table

metadata: [Option<HandleMetadata>; 1024]

Metadata for each handle

free_handles: Vec<Handle>

Stack of available handle numbers for O(1) allocation

Implementations

impl HandleTable

const MAX_HANDLES: usize = 1_024usize

pub fn new() -> Self

pub fn insert(&mut self, obj: KernelObject) -> Result<Handle, &'static str>

O(1) allocation with automatic metadata inference

pub fn insert_with_metadata( &mut self, obj: KernelObject, metadata: HandleMetadata, ) -> Result<Handle, &'static str>

O(1) allocation with explicit metadata

fn infer_metadata_from_object(object: &KernelObject) -> HandleMetadata

Infer metadata from KernelObject type and usage context

This function provides reasonable defaults for handle roles based on the KernelObject type. Applications can override this by using insert_with_metadata() to specify exact roles.

pub fn get(&self, handle: Handle) -> Option<&KernelObject>

O(1) access

pub fn remove(&mut self, handle: Handle) -> Option<KernelObject>

O(1) removal

pub fn update_metadata( &mut self, handle: Handle, new_metadata: HandleMetadata, ) -> Result<(), &'static str>

Update metadata for an existing handle

pub fn open_count(&self) -> usize

Get the number of open handles

pub fn active_handles(&self) -> Vec<Handle>

Get all active handles

pub fn close_all(&mut self)

Close all handles (for process termination)

pub fn is_valid_handle(&self, handle: Handle) -> bool

Check if a handle is valid

pub fn get_metadata(&self, handle: Handle) -> Option<&HandleMetadata>

Get metadata for a handle

pub fn iter_with_metadata( &self, ) -> impl Iterator<Item = (Handle, &KernelObject, &HandleMetadata)>

Iterator over handles with their objects and metadata

pub fn get_object_info(&self, handle: Handle) -> Option<KernelObjectInfo>

Get detailed information about a KernelObject for user space introspection

Trait Implementations

impl Clone for HandleTable

fn clone(&self) -> HandleTable

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for HandleTable

fn default() -> Self

Returns the “default value” for a type.