# CAIN-42 Sovereign Extension Containment: Compatibility Matrix

**Document Reference:** `CAIN42-COMPAT-SOVEREIGN-EXT-v1`  
**Classification:** Engineering Specification  
**Status:** VALIDATED ON LINUX 7.0.0-38-GENERIC (Ubuntu 26.04 LTS)  

---

## 1. Operating System & Kernel Support Matrix

| Subsystem / OS | Minimum Requirement | Recommended Production Target | Current Verification Environment | Support Tier |
|:---|:---|:---|:---|:---:|
| **Linux Kernel** | Linux 5.8 (cgroup BPF + BPF ringbuf) | Linux 6.6 LTS or Linux 6.8+ | Linux 7.0.0-38-generic SMP x86_64 | **Tier 1 (Certified)** |
| **Ubuntu Linux** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS / 26.04 LTS | Ubuntu 26.04.1 LTS (Resolute Raccoon) | **Tier 1 (Certified)** |
| **Debian Linux** | Debian 12 (Bookworm) | Debian 12+ | Tested via Debian-derivative packages | **Tier 1 (Supported)** |
| **RHEL / Rocky / Alma** | RHEL 9.2+ (cgroup v2 default) | RHEL 9.4+ | Requires cgroup v2 unified hierarchy | **Tier 2 (Supported)** |
| **Alpine / Musl** | Not recommended | Glibc-based distribution | Glibc 2.39+ required for Bubblewrap seccomp | **Tier 3 (Experimental)** |

---

## 2. Kernel Features & Subsystem Prerequisites

| Kernel Feature | Kernel Config Flag | Purpose | Status in Environment | Fail-Closed Fallback |
|:---|:---|:---|:---:|:---|
| **cgroup v2 Unified Hierarchy** | `CONFIG_CGROUPS=y` | Memory, CPU, and PID isolation; cgroup eBPF attachment | `Mounted at /sys/fs/cgroup` | Refuses container execution |
| **BPF Filesystem** | `CONFIG_BPF_FS=y` | Pinned map persistence and program sharing | `Mounted at /sys/fs/bpf` | Sentinel refuses to load |
| **cgroup BPF Socket Hooks** | `CONFIG_CGROUP_BPF=y` | `cgroup_skb/egress` network packet filtering | `Verified active` | Sentinel fails closed |
| **BPF Ring Buffer** | `CONFIG_BPF_SYSCALL=y` | High-throughput audit event emission | `Verified active (4MB)` | Drops to synchronous audit |
| **Kernel BTF (vmlinux)** | `CONFIG_DEBUG_INFO_BTF=y` | Compile-Once Run-Everywhere (CO-RE) | `/sys/kernel/btf/vmlinux (7.0MB)` | Requires local Clang headers |
| **Seccomp BPF** | `CONFIG_SECCOMP=y`, `CONFIG_SECCOMP_FILTER=y` | Syscall filtering for native sandboxes | `Verified active` | Refuses container execution |
| **User Namespaces** | `CONFIG_USER_NS=y` | Unprivileged rootless container isolation | `Verified active` | Refuses container execution |

---

## 3. Toolchain & Runtime Dependencies

| Component | Minimum Version | Tested Version | Verification Command | Purpose |
|:---|:---|:---|:---|:---|
| **Bubblewrap (`bwrap`)** | 0.8.0+ | 0.11.1 | `bwrap --version` | Native container sandboxing |
| **Clang / LLVM** | Clang 14+ | Clang 18+ | `clang --version` | Compiling eBPF C programs to BPF bytecode |
| **bpftool** | 6.0+ | 7.7.0 (v7.0.0 kernel) | `bpftool version` | Loading, attaching, and inspecting BPF objects |
| **Wasm Runtime** | Wasmedge 0.13+ / Wazero 1.5+ | WasmEdge 0.14+ | `wasmedge --version` | Sandboxed WebAssembly extension execution |
| **Python** | 3.10+ | Python 3.14.4 | `python3 --version` | Host control plane & daemon engine |
| **cryptography** | 40.0.0+ | 46.0.5 | `python3 -c "import cryptography"` | Ed25519 signing and verification |
| **sqlite3** | 3.35.0+ (WAL mode) | 3.45.1+ | `python3 -c "import sqlite3"` | Tamper-evident hash-chained audit ledger |

---

## 4. Hardware Architecture Compatibility

| Architecture | Status | Seccomp Syscall Offsets | Notes |
|:---|:---:|:---:|:---|
| **x86_64 (amd64)** | **Full (Production)** | Validated against Linux `asm/unistd_64.h` | 17 blocked syscalls formally verified (`ptrace=101, pivot_root=155, mount=165, unshare=272, etc.`). |
| **aarch64 (arm64)** | **Compatible** | Requires arm64 `asm/unistd.h` mapping | Supported under identical cgroup v2 and BPF infrastructure; seccomp table maps arm64 syscall numbers. |
