Struct mycelium_kernel::rt::Core

pub struct Core {
    scheduler: &'static StaticScheduler,
    id: usize,
    running: AtomicBool,
    rng: Xoroshiro128PlusPlus,
}

A kernel runtime for a single core.

Fields

scheduler: &'static StaticScheduler

The task scheduler for this core.

id: usize

This core’s ID.

ID 0 is the first CPU core started when the system boots.

running: AtomicBool

Set to false if this core should shut down.

rng: Xoroshiro128PlusPlus

Used to select the index of the next core to steal work from.

Selecting a random core index when work-stealing helps ensure we don’t have a situation where all idle steal from the first available worker, resulting in other cores ending up with huge queues of idle tasks while the first core’s queue is always empty.

This is not a cryptographically secure random number generator, since randomness of this value is not required for security. Instead, it just helps ensure a good distribution of load. Therefore, we use a fast, non-cryptographic RNG.

Implementations

impl Core

pub fn new() -> Self

pub fn tick(&mut self) -> bool

Runs one tick of the kernel main loop on this core.

Returns true if this core has more work to do, or false if it does not.

pub fn is_running(&self) -> bool

Returns true if this core is currently running.

pub fn stop(&self) -> bool

Stops this core if it is currently running.

Returns

• true if this core was running and is now stopping
• false if this core was not running.

pub fn run(&mut self)

Run this core until Core::stop is called.

fn try_steal(&mut self) -> usize

Trait Implementations

impl Default for Core

fn default() -> Self

Returns the “default value” for a type.