Repository navigation
v1.0.1
X3Dctl v1.0.1 Release Notes
Overview
Version 1.0.1 is a stability and refinement release for X3Dctl following the 1.0.0 milestone.
This update focuses on behavioral correctness, validation hardening, and documentation alignment with the 1.x stability guarantees.
X3Dctl remains a deterministic, command-driven utility for controlling AMD X3D CPU operating modes with no daemon, no polling, and no background state drift
Improvements
Refined Mode Enforcement
- Improved validation around global mode transitions.
- More robust handling of repeated mode invocations (idempotent behavior preserved).
- Clearer feedback when the system is already in the requested posture.
GPU IRQ Steering Stability
- Hardened GPU IRQ mask application logic.
- Improved restoration behavior when switching from
gaming→performance. - Better validation when
--no-irqis supplied. - Reduced risk of partial or stale mask states.
Mode-bound IRQ steering behavior remains:
gaming→ steer GPU IRQs to frequency CCDperformance→ restore full CPU mask
Profile Execution Consistency
-
Improved enforcement of:
- CPU affinity masks
- Nice levels
- Scheduler class
- I/O priority
-
Ensured deterministic inheritance for all child processes.
-
Tightened validation inside the privileged helper.
Profiles remain static and enforced within the helper (no runtime profile mutation)
CLI and UX Enhancements
- Clearer error output for invalid command combinations.
- Improved verbosity handling (
-v,-q). - Minor help/man page polish.
- Improved status output consistency.
Privilege Separation Hardening
- Additional safety checks in helper execution path.
- Improved configuration ownership validation.
- Reduced surface area for misconfiguration.
Strict privilege separation remains a core design goal
Documentation Updates
- Stability language aligned with the 1.x release series.
- Clarified profile model documentation.
- Minor formatting and consistency improvements.
The 1.x series guarantees stable CLI semantics and backward compatibility
Bug Fixes
-
Fixed edge cases where:
- IRQ masks could appear unchanged after repeated transitions.
- Affinity validation messages were misleading.
- Invalid profile entries produced incomplete feedback.
- Corrected minor documentation typos.
No Breaking Changes
- No CLI changes.
- No configuration format changes.
- No behavior regressions intended.
- Fully backward compatible with 1.0.0.
Summary
X3Dctl v1.0.1 strengthens determinism, improves validation clarity, and refines enforcement logic without expanding scope.
This release continues to honor the core design principles:
- No daemon
- No polling
- No automation magic
- Deterministic system posture
- Minimal privileged attack surface
Full Changelog: v1.0.0...v1.0.1