Skip to main content

SchedulerKnobs

Struct SchedulerKnobs 

Source
pub struct SchedulerKnobs {
    pub config: SchedulerConfig,
    pub seed: u64,
}
Expand description

The knobs that parameterize the emitted deterministic scheduler. This is the SAME SchedulerConfig the oracle runtime (logicaffeine_runtime) runs — the ready-queue policy (FIFO / LIFO / round-robin / seeded-random / priority), the clock (virtual Logical vs Wall), the default channel capacity, and the M:N workers count (1 = cooperative single core, N = work-stealing) — plus the seed that drives the seeded chooser for the random-choice points (TaskPick under Random, SelectWinner, TimerTieBreak). Emitting C straight from a SchedulerConfig guarantees the AOT scheduler’s knobs are ONE-TO-ONE with the oracle’s, so a program run at knobs on the VM and the same knobs in AOT-C agree.

The DEFAULT — Fifo / workers = 1 / Logical / seed = 0 — is the exact point every determinism lock pins against run_vm_concurrent (which uses SchedulerConfig::default()), and is the fixed policy the hand-written scheduler already implements (child-first spawn, FIFO ready queue, earliest-timer-first virtual clock).

Fields§

§config: SchedulerConfig

The oracle-shared scheduler config: policy / clock / default_channel_capacity / preempt_every / workers.

§seed: u64

Seed for the emitted SplitMix64 chooser (mirrors logicaffeine_runtime::seed::SeededRng). Only observable under SchedulePolicy::Random or on a genuine multi-ready Select / timer tie.

Implementations§

Source§

impl SchedulerKnobs

Source

pub fn emit_defines(&self) -> String

The C #define block the emitted scheduler reads for its knobs. Prepended to the stepped tier’s C. The policy / clock enums match the emitted scheduler’s LOGOS_SCHED_* / LOGOS_CLOCK_* constants one-to-one; logos_ready_pop branches on LOGOS_SCHED_POLICY, the timer/select tie-breaks draw from a SplitMix64 seeded by LOGOS_SCHED_SEED, and channels default to LOGOS_CHAN_DEFAULT_CAP.

Trait Implementations§

Source§

impl Clone for SchedulerKnobs

Source§

fn clone(&self) -> SchedulerKnobs

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for SchedulerKnobs

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for SchedulerKnobs

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl PartialEq for SchedulerKnobs

Source§

fn eq(&self, other: &SchedulerKnobs) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Copy for SchedulerKnobs

Source§

impl Eq for SchedulerKnobs

Source§

impl StructuralPartialEq for SchedulerKnobs

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<T> Downcast for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,