docs: accounting/psi: document /proc/pressure/irq and irq.pressure
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
@@ -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
Quoted 11 lines · Tao Cui
From: Tao Cui <[email protected]>
psi.rstlists only cpu, memory and io, omitting the IRQ/SOFTIRQ pressure exposed as/proc/pressure/irq(and irq.pressure per cgroup) underCONFIG_IRQ_TIME_ACCOUNTING.admin-guide/cgroup-v2.rstalready documents irq.pressure; bringpsi.rstin 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 <[email protected]>
Looks good, thank you.