Struct KernelThreads 

pub struct KernelThreads {
    pub starnix_process: Process,
    /* private fields */
}

The threads that the kernel runs internally.

These threads run in the main starnix process and outlive any specific userspace process.

Fields

starnix_process: Process

The main starnix process. This process is used to create new processes when using the restricted executor.

Implementations

impl KernelThreads

pub fn new(kernel: Weak<Kernel>) -> Self

Create a KernelThreads object for the given Kernel.

Must be called in the initial Starnix process on a thread with an async executor. This function captures the async executor for this thread for use with spawned futures.

Used during kernel boot.

pub fn init(&self, system_task: CurrentTask) -> Result<(), Errno>

Initialize this object with the system task that will be used for spawned threads.

This function must be called before this object is used to spawn threads.

pub fn spawn_future(&self, future: impl AsyncFnOnce() + Send + 'static)

Spawn an async task in the main async executor to await the given future.

Use this function to run async tasks in the background. These tasks cannot block or else they will starve the main async executor.

Prefer this function to spawn for non-blocking work.

pub fn spawner(&self) -> &DynamicThreadSpawner

The dynamic thread spawner used to spawn threads.

To spawn a thread in this thread pool, use spawn().

pub fn system_task(&self) -> &CurrentTask

Access the CurrentTask for the kernel main thread.

This function can only be called from the kernel main thread itself.

pub fn unlocked_for_async(&self) -> RefMut<'_, Locked<Unlocked>>

Access the Unlocked state.

This function is intended for limited use in async contexts and can only be called from the kernel main thread.

pub fn system_thread_group(&self) -> Arc<ThreadGroup>

Access the ThreadGroup for the system tasks.

This function can be safely called from anywhere as soon as KernelThreads::init has been called.

Trait Implementations

impl Drop for KernelThreads

fn drop(&mut self)

Executes the destructor for this type.