silicera 0.1.0

Hardware-native program specialization for AMD Zen — core discovery, measurement, and HNEP
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

//! Error types for Silicera operations.

use thiserror::Error;

/// Convenient result alias.
pub type Result<T> = std::result::Result<T, SiliceraError>;

/// Errors produced by Silicera core operations.
#[derive(Debug, Error, Clone, PartialEq, Eq)]
pub enum SiliceraError {
    /// CPU vendor is not AMD, or CPUID is unavailable.
    #[error("unsupported CPU: {0}")]
    UnsupportedCpu(String),

    /// AMD CPU detected but microarchitecture is outside supported Zen3/Zen4/Zen5.
    #[error("unsupported AMD microarchitecture: {0}")]
    UnsupportedMicroarch(String),

    /// Topology or knowledge-pack validation failed.
    #[error("hardware validation failed: {0}")]
    ValidationFailed(String),

    /// Fingerprint / profile mismatch at load or dispatch time.
    #[error("profile mismatch: {0}")]
    ProfileMismatch(String),

    /// HNEP integrity digest does not match payload.
    #[error("integrity check failed: {0}")]
    IntegrityFailed(String),

    /// Measurement instability exceeded configured thresholds.
    #[error("measurement unstable: {0}")]
    MeasurementUnstable(String),

    /// Correctness validation rejected a variant.
    #[error("correctness failure: {0}")]
    CorrectnessFailure(String),

    /// Regression gate rejected a candidate (worse than baseline).
    #[error("regression rejected: {0}")]
    RegressionRejected(String),

    /// I/O or serialization failure.
    #[error("I/O error: {0}")]
    Io(String),

    /// Parse / format error.
    #[error("parse error: {0}")]
    Parse(String),

    /// Knowledge pack missing or incomplete.
    #[error("knowledge pack error: {0}")]
    KnowledgePack(String),

    /// Profile is stale relative to environment snapshot policy.
    #[error("stale profile: {0}")]
    StaleProfile(String),

    /// Generic internal error.
    #[error("internal error: {0}")]
    Internal(String),
}

impl From<std::io::Error> for SiliceraError {
    fn from(e: std::io::Error) -> Self {
        SiliceraError::Io(e.to_string())
    }
}

impl From<serde_json::Error> for SiliceraError {
    fn from(e: serde_json::Error) -> Self {
        SiliceraError::Parse(e.to_string())
    }
}

impl From<toml::de::Error> for SiliceraError {
    fn from(e: toml::de::Error) -> Self {
        SiliceraError::Parse(e.to_string())
    }
}