Struct Thread 

pub struct Thread { /* private fields */ }

Main thread handle with RAII resource management.

This represents a thread and automatically manages its resources through reference counting. When the last reference is dropped, the thread’s stack and other resources are automatically cleaned up.

Implementations

impl Thread

pub fn new( id: ThreadId, stack: Stack, entry_point: fn(), priority: u8, ) -> (Self, JoinHandle)

Create a new thread with the given parameters.

Arguments

• id - Unique identifier for this thread
• stack - Stack allocated for this thread
• entry_point - Function to execute in this thread
• priority - Thread priority (0-255, higher = more important)

Returns

A new Thread instance and corresponding JoinHandle.

pub fn id(&self) -> ThreadId

Get the thread’s unique identifier.

pub fn state(&self) -> ThreadState

Get the thread’s current state.

pub fn set_state(&self, new_state: ThreadState)

Set the thread’s state.

Arguments

• new_state - The new state to set

pub fn priority(&self) -> u8

Get the thread’s priority.

pub fn set_priority(&self, new_priority: u8)

Set the thread’s priority.

Arguments

• new_priority - The new priority (0-255, higher = more important)

pub fn is_runnable(&self) -> bool

Check if this thread is runnable (ready or running).

pub fn context_ptr(&self) -> *mut <DefaultArch as Arch>::SavedContext

Get a pointer to the thread’s saved context.

Returns

A pointer to the saved context, or null if not initialized.

pub fn stack_bottom(&self) -> Option<*mut u8>

Get the thread’s stack bottom (initial stack pointer).

pub fn check_stack_integrity(&self) -> bool

Check if the thread’s stack canary is intact (stack overflow detection).

pub fn start_time_slice(&self)

Start a new time slice for this thread.

This should be called when the thread is scheduled to run.

pub fn should_preempt(&self) -> bool

Update the thread’s virtual runtime and check if preemption is needed.

Returns

true if the thread’s time slice has expired and it should be preempted.

pub fn vruntime(&self) -> u64

Get the thread’s current virtual runtime.

This is used by the scheduler for fair scheduling decisions.

pub fn set_name(&self, name: String)

Set the thread name for debugging purposes.

pub fn name(&self) -> Option<String>

Get the thread name.

pub fn set_cpu_affinity(&self, affinity: u64)

Set CPU affinity mask.

pub fn cpu_affinity(&self) -> u64

Get CPU affinity mask.

pub fn set_group_id(&self, group_id: u32)

Set thread group ID.

pub fn group_id(&self) -> u32

Get thread group ID.

pub fn set_time_slice(&self, duration: Duration)

Set custom time slice duration.

pub fn set_critical(&self, critical: bool)

Set whether this thread is critical.

pub fn is_critical(&self) -> bool

Check if this thread is critical.

pub fn set_preemptible(&self, preemptible: bool)

Set whether this thread can be preempted.

pub fn is_preemptible(&self) -> bool

Check if this thread can be preempted.

pub fn reserve_tls(&self, size: usize)

Reserve thread-local storage space.

pub fn tls_size(&self) -> usize

Get reserved TLS size.

pub fn set_debug_info(&self, enabled: bool)

Enable or disable debug information.

pub fn debug_info_enabled(&self) -> bool

Check if debug information is enabled.

pub fn set_realtime_priority(&self, rt_priority: u8)

Set real-time priority.

pub fn realtime_priority(&self) -> u8

Get real-time priority.

pub fn set_nice_value(&self, nice: i8)

Set nice value for process priority.

pub fn nice_value(&self) -> i8

Get nice value.

pub fn set_inherit_signal_mask(&self, inherit: bool)

Set whether to inherit parent’s signal mask.

pub fn inherits_signal_mask(&self) -> bool

Check if inheriting parent’s signal mask.

pub fn set_environment(&self, env: BTreeMap<String, String>)

Set custom environment variables.

pub fn environment(&self) -> Option<BTreeMap<String, String>>

Get environment variables.

pub fn set_max_cpu_time(&self, max_time: u64)

Set maximum CPU time limit.

pub fn max_cpu_time(&self) -> u64

Get maximum CPU time limit.

pub fn set_max_memory(&self, max_memory: usize)

Set maximum memory usage limit.

pub fn max_memory(&self) -> usize

Get maximum memory usage limit.

pub fn set_max_files(&self, max_files: u32)

Set maximum file descriptors limit.

pub fn max_files(&self) -> u32

Get maximum file descriptors limit.

pub fn set_max_children(&self, max_children: u32)

Set maximum child threads limit.

pub fn max_children(&self) -> u32

Get maximum child threads limit.

pub fn record_memory_allocation(&self, size: u64)

Record memory allocation for this thread.

pub fn record_memory_deallocation(&self, size: u64)

Record memory deallocation for this thread.

pub fn record_cpu_time(&self, duration: Duration, user_mode: bool)

Record CPU time usage for this thread.

pub fn update_stack_usage_metrics(&self, current_usage: usize)

Update stack usage for this thread.

Trait Implementations

impl Clone for Thread

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Send for Thread

impl Sync for Thread