Skip to contentSkip to conversation

docs: accounting/psi: document /proc/pressure/irq and irq.pressure

PATCH In review Tao Cui 2 participants 2 messages Jul 23 Documentation

lore
Share & tools
lore

Tao Cui

author
#0 lore raw

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

From: Tao Cui <[email protected]>

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.

---
 Documentation/accounting/psi.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)
Documentation/accounting/psi.rst +11 -3
index d455db3e5808..6d761625529d 100644
@@ -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.
Signature · 1 line
2.43.0
Acked-by on v1 1/1
#1 lore raw
Quoted 11 lines · Tao Cui

From: Tao Cui <[email protected]>

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.

Looks good, thank you.