cpu-local 0.4.0

Architecture CPU-local register capability for TGOSKits
Documentation
use ax_cpu::registers;

use super::*;

pub(super) const CURRENT_MODEL: ArchitectureCurrentModel = ArchitectureCurrentModel {
    linux_current: CurrentContextSource::ArchitectureRegister,
    unikernel_tls: CurrentContextSource::RuntimeAnchor,
};

pub(super) struct Backend;

impl ArchitectureRegisterBackend for Backend {}

pub(super) fn validate_environment() -> Result<(), CpuLocalError> {
    Ok(())
}

pub(super) unsafe fn install_cpu_base(area_base: usize, boot_context: usize) {
    // SAFETY: the caller owns offline CPU initialization with traps disabled.
    unsafe {
        registers::write_cpu_anchor(area_base);
        if !cfg!(kernel_tls) {
            registers::write_tp(boot_context);
        }
    }
}

pub(super) unsafe fn read_cpu_base() -> Result<usize, CpuLocalError> {
    let (area_base, shadow) = registers::read_cpu_anchor();
    if area_base != shadow {
        super::fatal_register_invariant();
    }
    Ok(area_base)
}

pub(super) unsafe fn read_current_context(area_base: usize) -> usize {
    if cfg!(kernel_tls) {
        unsafe { area_runtime_anchor(area_base) }.current_context_raw()
    } else {
        registers::read_tp()
    }
}

pub(super) unsafe fn write_current_context(value: usize) {
    if !cfg!(kernel_tls) {
        unsafe { registers::write_tp(value) };
    }
}

#[cfg(kernel_tls)]
pub(super) unsafe fn read_kernel_tls() -> usize {
    registers::read_thread_pointer().as_usize()
}

#[cfg(kernel_tls)]
pub(super) unsafe fn write_kernel_tls(value: usize) {
    unsafe { registers::write_thread_pointer(ax_cpu::context::KernelTlsBase::new(value)) };
}

unsafe fn area_runtime_anchor(area_base: usize) -> &'static crate::CpuRuntimeAnchor {
    unsafe {
        &*((area_base + crate::CPU_AREA_RUNTIME_ANCHOR_OFFSET) as *const crate::CpuRuntimeAnchor)
    }
}