All of lore.kernel.org
 help / color / mirror / Atom feed
From: Tao Cui <cui.tao@linux.dev>
To: Johannes Weiner <hannes@cmpxchg.org>,
	Suren Baghdasaryan <surenb@google.com>
Cc: linux-doc@vger.kernel.org, Peter Zijlstra <peterz@infradead.org>,
	Jonathan Corbet <corbet@lwn.net>, Tao Cui <cuitao@kylinos.cn>,
	linux-kernel@vger.kernel.org, cui.tao@linux.dev
Subject: [PATCH] docs: accounting/psi: drop stale 500ms window minimum from trigger docs
Date: Thu, 23 Jul 2026 20:50:25 +0800	[thread overview]
Message-ID: <20260723125025.457841-1-cui.tao@linux.dev> (raw)

From: Tao Cui <cuitao@kylinos.cn>

psi.rst says trigger windows range "from 500ms to 10s" with a 50ms min
polling interval. That minimum was removed in commit 519fabc7aaba ("psi:
remove 500ms min window size limitation for triggers"): the polling-rate
protection moved to gating trigger creation behind CAP_SYS_RESOURCE,
which also stopped capping psi event latency.

Update the wording accordingly: windows up to 10s with no enforced
minimum; trigger creation requires CAP_SYS_RESOURCE on cgroup pressure
files, while unprivileged users on /proc/pressure/ are limited to 2s
multiples.

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

diff --git a/Documentation/accounting/psi.rst b/Documentation/accounting/psi.rst
index d455db3e5808..aae57fb5f15c 100644
--- a/Documentation/accounting/psi.rst
+++ b/Documentation/accounting/psi.rst
@@ -99,15 +99,14 @@ psi metric and deactivates upon exit from the stall state. While system is
 in the stall state psi signal growth is monitored at a rate of 10 times per
 tracking window.
 
-The kernel accepts window sizes ranging from 500ms to 10s, therefore min
-monitoring update interval is 50ms and max is 1s. Min limit is set to
-prevent overly frequent polling. Max limit is chosen as a high enough number
-after which monitors are most likely not needed and psi averages can be used
-instead.
-
-Unprivileged users can also create monitors, with the only limitation that the
-window size must be a multiple of 2s, in order to prevent excessive resource
-usage.
+The kernel accepts window sizes up to 10s. The 10s maximum is chosen as a
+high enough number after which monitors are most likely not needed and psi
+averages can be used instead.
+
+To prevent excessive resource usage, trigger creation is restricted to
+privileged users (CAP_SYS_RESOURCE) on cgroup pressure files; on the
+system-wide /proc/pressure/ files unprivileged users can create monitors
+as well, limited to window sizes that are a multiple of 2s.
 
 When activated, psi monitor stays active for at least the duration of one
 tracking window to avoid repeated activations/deactivations when system is
-- 
2.43.0


                 reply	other threads:[~2026-07-23 12:51 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260723125025.457841-1-cui.tao@linux.dev \
    --to=cui.tao@linux.dev \
    --cc=corbet@lwn.net \
    --cc=cuitao@kylinos.cn \
    --cc=hannes@cmpxchg.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=peterz@infradead.org \
    --cc=surenb@google.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.