[ANNOUNCE] rteval-v3.12

John Kacur <[email protected]> Mon, 27 Jul 2026 15:28:10 -0400
Newsgroups org.kernel.vger.linux-rt-users,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
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