[PATCH 14/15] Documentation: isolation: Document DHEI sysfs interfaces

Qiliang Yuan
2026-03-25T09:11:36Z

---
.../ABI/testing/sysfs-kernel-housekeeping | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-kernel-housekeeping b/Documentation/ABI/testing/sysfs-kernel-housekeeping
new file mode 100644
index 0000000000000..3648578200111
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-kernel-housekeeping
@@ -0,0 +1,22 @@
+What: /sys/kernel/housekeeping/
+Date: March 2026
+Contact: Qiliang Yuan <realwujing@gmail.com>
+Description:
+ Directory containing the dynamic housekeeping configuration
+ for various kernel subsystems.
+
+ Each file represents a specific housekeeping type:
+ - timer: Timer and hrtimer interrupts.
+ - rcu: RCU callback offloading and GP kthreads.
+ - misc: Miscellaneous kernel services (e.g. kcompactd).
+ - tick: Dynamic full dynticks (NOHZ_FULL) state.
+ - domain: Scheduler domain isolation.
+ - workqueue: Workqueue affinity.
+ - managed_irq: Managed interrupts migration.
+ - kthread: General kernel thread affinity.
+ - smt_aware_mode: SMT-aware isolation toggle (0/1).
+ When enabled, writing a mask that does not include all
+ sibling threads of a core will be rejected with -EINVAL.
+
+ Writing a CPULIST to the type files dynamically updates the
+ housekeeping mask for the corresponding type.

--
2.43.0