Struct HotswapConfig 

pub struct HotswapConfig {
    pub mode: TierMode,
    pub thresholds: TierThresholds,
    pub force_tier: Option<Tier>,
    pub pins: PinSet,
}

“When does each allowed opt run” — the sibling to OptimizationConfig (HOTSWAP §8). mode picks the escalation policy, thresholds the rungs, force_tier pins a fixed tier for deterministic tests, and pins overrides individual opts.

Fields

mode: TierMode

thresholds: TierThresholds

force_tier: Option<Tier>

Forces a fixed tier regardless of hotness — the determinism lever for differential tests (LOGOS_FORCE_TIER). None ⇒ derive from mode + count.

pins: PinSet

Implementations

impl HotswapConfig

pub fn effective_tier(&self, count: u32) -> Tier

The tier a unit with count accumulated calls/back-edges should run at, under this config’s mode (and any force_tier override).

pub fn pin(&self, opt: Opt) -> Option<Pin>

This config’s pin for opt, if any.

pub fn run_tier(&self) -> Tier

The tier at which the run path optimizes UPFRONT, before the program executes. Eager pays the full optimizer (T3, today’s behavior); Tiered/Baseline start at the baseline (T0) and rely on the native tier — and, later, per-function re-optimization — to escalate hot code during the run, reclaiming the upfront optimizer cost (HOTSWAP §12.1). force_tier overrides everything (test determinism). Distinct from effective_tier, which maps a per-unit hotness COUNT to a tier; this maps the program-level MODE to the upfront tier.

pub fn from_env() -> Self

Build from the environment — the single external entry point (HOTSWAP §8). LOGOS_HOTSWAP=off forces Eager; LOGOS_TIER_PROFILE picks the preset; LOGOS_FORCE_TIER pins a fixed tier; LOGOS_TIER_PIN sets per-opt pins.

pub fn from_spec( hotswap: Option<&str>, profile: Option<&str>, force_tier: Option<&str>, thresholds: TierThresholds, pin_spec: Option<&str>, ) -> Self

The pure, testable core of from_env.

Trait Implementations

impl Clone for HotswapConfig

fn clone(&self) -> HotswapConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HotswapConfig

impl Debug for HotswapConfig

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

Formats the value using the given formatter.

impl Default for HotswapConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for HotswapConfig

impl PartialEq for HotswapConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HotswapConfig