[ANNOUNCE] rteval-v3.12
From: John Kacur
Date: Mon Jul 27 2026 - 15:28:37 EST
We are happy to announce the release of rteval-3.12
rteval-3.12 focuses on robustness improvements and container support.
New Features:
* Container detection and warning - Detects when running in containers
* Overflow bucket support - Handles extreme latencies exceeding histogram range
* --housekeeping-isolated flag - Better CPU isolation control
Improvements:
* Improved histogram parsing robustness for cyclictest and timerlat
* Enhanced timerlat stoptrace trace analysis and XML capture
* Process blocklist to prevent shutdown issues
* Better cpuset migration and debug logging
Bug Fixes:
* Fix stressng --taskset argument parsing
* Fix collapse_cpulist to handle duplicate CPU numbers
* Make thread excepthook portable and support chaining
Documentation:
* Add AGENTS.md guide for AI coding assistants
* License harmonization (GPL-2.0-only → GPL-2.0-or-later)
To fetch
Clone
git://git.kernel.org/pub/scm/utils/rteval/rteval.git
Branch: main
Tag: v3.12
Tarballs available here:
https://kernel.org/pub/linux/utils/rteval
Older version tarballs are available here:
https://kernel.org/pub/linux/utils/rteval/older
To accommodate distributions that require this, I have linked the last
version v3.11 from the older directory to the current directory
Bug reports, patches, etc are always welcome.
Enjoy!
Stats: 21 files changed, 1833 insertions, 48 deletions
John Kacur (19):
rteval: cyclictest: Improve handling of truncated histogram output
rteval: timerlat: Improve handling of truncated histogram output
rteval: Add container detection module
rteval: Add container detection and warning
rteval: Add AGENTS.md guide for AI coding assistants
rteval: Fix collapse_cpulist to handle duplicate CPU numbers
rteval: Add process blocklist to prevent shutdown issues
rteval: Make thread excepthook portable and support chaining
rteval: Set measurement cpuset to partition=isolated for CPU isolation
rteval: Add --housekeeping-isolated flag
rteval: Fix measurement module cpuset migration and debug logging
rteval: Fix timerlat stoptrace trace analysis capture in XML
rteval: Change test file licenses from GPL-2.0-only to
GPL-2.0-or-later
rteval: Fix stressng --taskset argument parsing
cyclictest: Add overflow bucket to handle latencies exceeding
histogram range
rteval: Improve overflow bucket handling and add timerlat support
rteval: Refactor timerlat parsing and fix max line duplication bug
rteval: Reduce verbose debug logging in timerlat stoptrace parsing
rteval: Create rteval-3.12
AGENTS.md | 466 +++++++++++++++++++++++
Makefile | 14 +-
README-tests | 6 +
rteval-cmd | 20 +-
rteval/__init__.py | 17 +-
rteval/cpulist_utils.py | 4 +-
rteval/cpuset.py | 41 ++
rteval/cpusetmanager.py | 11 +-
rteval/modules/loads/hackbench.py | 10 +-
rteval/modules/loads/stressng.py | 2 +-
rteval/modules/measurement/cyclictest.py | 102 ++++-
rteval/modules/measurement/timerlat.py | 171 ++++++++-
rteval/rteval_text.xsl | 34 +-
rteval/sysinfo/__init__.py | 5 +-
rteval/sysinfo/containercheck.py | 92 +++++
rteval/version.py | 2 +-
tests/README.md | 322 ++++++++++++++++
tests/run_tests.sh | 5 +
tests/test_cpusetmanager.py | 412 ++++++++++++++++++++
tests/test_process_blocklist.py | 143 +++++++
tests/unittest-legacy.py | 2 +-
21 files changed, 1833 insertions(+), 48 deletions(-)
create mode 100644 AGENTS.md
create mode 100644 rteval/sysinfo/containercheck.py
create mode 100644 tests/README.md
create mode 100644 tests/test_cpusetmanager.py
create mode 100644 tests/test_process_blocklist.py
--
2.55.0