gdt-cpus 0.2606.1

Game Developer's Toolkit for CPU Management
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
81
82
83
84
85
86

//! Fixture-driven Linux detection tests.
//!
//! Each fixture is a recorded or synthetic `/sys` (+ minimal `/proc`) tree
//! plus an `expected.txt` of flat `key=value` assertions - the checker and
//! the format contract live in `crate::platform::fixture_expected`.

use super::detect_at;
use crate::platform::fixture_expected::{check_expected, fixture_root};

/// Runs detection against a fixture tree and checks every `expected.txt` line.
fn run_fixture(name: &str) {
    let root = fixture_root(name);

    // NOTE: the recorded corpus is external to the crate. Plain `cargo test`
    // without the data checkout skips; CI should set GDT_CPUS_FIXTURES or fetch
    // the shared testdata tree.
    if !root.exists() {
        eprintln!(
            "fixture {} not present at {} (set GDT_CPUS_FIXTURES to enable) - skipped",
            name,
            root.display()
        );
        return;
    }

    let info = detect_at(&root.join("sys"), &root.join("proc"))
        .unwrap_or_else(|e| panic!("detect_at failed for fixture {}: {}", name, e));

    check_expected(&info, name);
}

#[test]
fn fixture_5950x_two_l3_domains() {
    run_fixture("sysfs-5950x");
}

#[test]
fn fixture_wsl2_virtualized_l3() {
    run_fixture("sysfs-wsl2");
}

#[test]
fn fixture_hybrid_x86_core_type_chain() {
    run_fixture("sysfs-hybrid-x86");
}

#[test]
fn fixture_biglittle_arm_capacity_thresholds() {
    run_fixture("sysfs-biglittle-arm");
}

#[test]
fn fixture_i7_6700_monolithic_l3() {
    run_fixture("sysfs-i7-6700");
}

#[test]
fn fixture_cix_p1_three_tier_capacity() {
    run_fixture("sysfs-cix-p1");
}

#[test]
fn fixture_pi5_homogeneous_degenerate_numa() {
    run_fixture("sysfs-pi5");
}

#[test]
fn fixture_numa2_disjoint_nodes_survive() {
    run_fixture("sysfs-numa2");
}

#[test]
fn fixture_i7_6700_lxc_sparse_online() {
    // cpuset-limited LXC (online = "1,4") whose L2 shared_cpu_list still names
    // the offline host siblings (cpu1 -> "1,5", cpu4 -> "0,4"). A domain's
    // lowest member can be an offline lp, so detection's append order inverts
    // the ascending-lowest-lp contract; this guards the post-sort normalization.
    run_fixture("sysfs-i7-6700-lxc");
}

#[test]
fn fixture_numa_sparse_node_ids() {
    // Sparse node ids (node1 absent): guards the break-on-first-gap bug that
    // counted only contiguous nodes and stranded later-node LPs on node 0.
    run_fixture("sysfs-numa-sparse");
}