Skip to content

v1.0.1

Choose a tag to compare

@GrandBIRDLizard GrandBIRDLizard released this 03 Mar 22:13
· 38 commits to master since this release
8110888

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-irq is supplied.
  • Reduced risk of partial or stale mask states.

Mode-bound IRQ steering behavior remains:

  • gaming → steer GPU IRQs to frequency CCD
  • performance → 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