Struct ThreadBuilder 

pub struct ThreadBuilder { /* private fields */ }

Builder for configuring and creating new threads.

This provides a comprehensive interface for setting thread parameters before spawning, with advanced options for scheduling, debugging, and resource management.

Implementations

impl ThreadBuilder

pub fn new() -> Self

Create a new thread builder with default settings.

pub fn stack_size_class(self, size_class: StackSizeClass) -> Self

Set the stack size class for the thread.

pub fn stack_size(self, size: usize) -> Self

Set the stack size in bytes.

pub fn priority(self, priority: u8) -> Self

Set the thread priority.

pub fn name<T: Into<String>>(self, name: T) -> Self

Set the thread name for debugging purposes.

pub fn cpu_affinity(self, mask: u64) -> Self

Set CPU affinity mask (which CPUs this thread can run on).

pub fn group_id(self, group: u32) -> Self

Set thread group ID for resource accounting.

pub fn stack_guard_pages(self, enabled: bool) -> Self

Enable or disable stack guard pages (requires MMU feature).

pub fn stack_canary(self, enabled: bool) -> Self

Enable or disable stack canary protection.

pub fn custom_canary(self, canary: u64) -> Self

Set custom stack canary value.

pub fn time_slice(self, duration: Duration) -> Self

Set custom time slice duration.

pub fn critical(self, critical: bool) -> Self

Mark this thread as critical (affects scheduling priority).

pub fn preemptible(self, preemptible: bool) -> Self

Set whether this thread can be preempted.

pub fn tls_size(self, size: usize) -> Self

Reserve space for thread-local storage.

pub fn debug_info(self, enabled: bool) -> Self

Enable or disable detailed debugging information.

pub fn attributes(self, attributes: ThreadAttributes) -> Self

Set custom thread attributes.

pub fn spawn( self, thread_id: ThreadId, stack_pool: &StackPool, entry_point: fn(), ) -> Result<(Thread, JoinHandle), SpawnError>

Spawn a new thread with the configured parameters.

Arguments

• thread_id - Unique identifier for the new thread
• stack_pool - Stack pool to allocate from
• entry_point - Function to run in the new thread

Returns

A tuple of (Thread, JoinHandle) if successful, or an error if thread creation fails.

Trait Implementations

impl Default for ThreadBuilder

fn default() -> Self

Returns the “default value” for a type.