Struct HandleMetadata

pub struct HandleMetadata {
    pub handle_type: HandleType,
    pub access_mode: AccessMode,
    pub special_semantics: Option<SpecialSemantics>,
}

Handle metadata for managing special semantics and ABI conversion

This metadata describes HOW a handle is being used, not WHAT the underlying KernelObject is. This enables proper ABI conversion, security policies, and resource management.

Examples of Role-based Usage

// Same file object used in different roles
let config_file = file_obj.clone();
let log_file = file_obj.clone();
 
// Handle for reading configuration
let config_handle = task.handle_table.insert_with_metadata(
    KernelObject::File(config_file),
    HandleMetadata {
        handle_type: HandleType::ConfigFile,
        access_mode: AccessMode::ReadOnly,
        special_semantics: Some(SpecialSemantics::CloseOnExec),
    }
)?;
 
// Handle for writing logs
let log_handle = task.handle_table.insert_with_metadata(
    KernelObject::File(log_file),
    HandleMetadata {
        handle_type: HandleType::LogOutput,
        access_mode: AccessMode::WriteOnly,
        special_semantics: Some(SpecialSemantics::Append),
    }
)?;

Fields

handle_type: HandleType

access_mode: AccessMode

special_semantics: Option<SpecialSemantics>

Trait Implementations

impl Clone for HandleMetadata

fn clone(&self) -> HandleMetadata

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HandleMetadata

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

Formats the value using the given formatter.

impl Default for HandleMetadata

fn default() -> Self

Returns the “default value” for a type.