[PATCH] docs: accounting/psi: document /proc/pressure/irq and irq.pressure

[PATCH] docs: accounting/psi: document /proc/pressure/irq and irq.pressure

[Tao Cui]

From: Tao Cui <cuitao@kylinos.cn>

psi.rst lists only cpu, memory and io, omitting the IRQ/SOFTIRQ pressure
exposed as /proc/pressure/irq (and irq.pressure per cgroup) under
CONFIG_IRQ_TIME_ACCOUNTING. admin-guide/cgroup-v2.rst already documents
irq.pressure; bring psi.rst in line.

IRQ pressure is tracked only for the "full" state: there is no "some"
line, and writing a "some" trigger returns EINVAL.

Signed-off-by: Tao Cui <cuitao@kylinos.cn>
---
 Documentation/accounting/psi.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/Documentation/accounting/psi.rst b/Documentation/accounting/psi.rst
index d455db3e5808..6d761625529d 100644
--- a/Documentation/accounting/psi.rst
+++ b/Documentation/accounting/psi.rst
@@ -35,7 +35,8 @@ Pressure interface
 ==================
 
 Pressure information for each resource is exported through the
-respective file in /proc/pressure/ -- cpu, memory, and io.
+respective file in /proc/pressure/ -- cpu, memory, io and, when the
+kernel is built with CONFIG_IRQ_TIME_ACCOUNTING, irq.
 
 The format is as such::
 
@@ -57,6 +58,12 @@ stall state is tracked separately and exported in the "full" averages.
 CPU full is undefined at the system level, but has been reported
 since 5.13, so it is set to zero for backward compatibility.
 
+Unlike the other resources, IRQ pressure is tracked only for the
+"full" state, which accounts for CPU time consumed by interrupt
+handling and therefore unavailable to tasks. The "some" state is not
+reported, and writing a "some" trigger to /proc/pressure/irq fails
+with EINVAL.
+
 The ratios (in %) are tracked as recent trends over ten, sixty, and
 three hundred second windows, which gives insight into short term events
 as well as medium and long term trends. The total absolute stall time
@@ -181,8 +188,9 @@ Cgroup2 interface
 In a system with a CONFIG_CGROUPS=y kernel and the cgroup2 filesystem
 mounted, pressure stall information is also tracked for tasks grouped
 into cgroups. Each subdirectory in the cgroupfs mountpoint contains
-cpu.pressure, memory.pressure, and io.pressure files; the format is
-the same as the /proc/pressure/ files.
+cpu.pressure, memory.pressure, io.pressure and, with
+CONFIG_IRQ_TIME_ACCOUNTING, irq.pressure files; the format is the same
+as the /proc/pressure/ files.
 
 Per-cgroup psi monitors can be specified and used the same way as
 system-wide ones.
-- 
2.43.0

Re: [PATCH] docs: accounting/psi: document /proc/pressure/irq and irq.pressure

[Johannes Weiner]

On Thu, Jul 23, 2026 at 08:36:54PM +0800, Tao Cui wrote:
> From: Tao Cui <cuitao@kylinos.cn>
> 
> psi.rst lists only cpu, memory and io, omitting the IRQ/SOFTIRQ pressure
> exposed as /proc/pressure/irq (and irq.pressure per cgroup) under
> CONFIG_IRQ_TIME_ACCOUNTING. admin-guide/cgroup-v2.rst already documents
> irq.pressure; bring psi.rst in line.
> 
> IRQ pressure is tracked only for the "full" state: there is no "some"
> line, and writing a "some" trigger returns EINVAL.
> 
> Signed-off-by: Tao Cui <cuitao@kylinos.cn>

Looks good, thank you.

Acked-by: Johannes Weiner <hannes@cmpxchg.org>