linux-kernel - [PATCH 2/2] psi: add description about multi level pressure trigger

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20220516033524.3130816-2-chenwandun@huawei.com>
Date:   Mon, 16 May 2022 11:35:24 +0800
From:   Chen Wandun <chenwandun@...wei.com>
To:     <linux-kernel@...r.kernel.org>, <hannes@...xchg.org>,
        <surenb@...gle.com>, <alexs@...nel.org>, <corbet@....net>,
        <linux-doc@...r.kernel.org>
Subject: [PATCH 2/2] psi: add description about multi level pressure trigger

add description about multi level pressure tirgger in documentation
about psi.

Signed-off-by: Chen Wandun <chenwandun@...wei.com>
---
 Documentation/accounting/psi.rst                    | 12 ++++++------
 Documentation/translations/zh_CN/accounting/psi.rst | 11 ++++++-----
 2 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/Documentation/accounting/psi.rst b/Documentation/accounting/psi.rst
index 860fe651d645..7abfe4fff201 100644
--- a/Documentation/accounting/psi.rst
+++ b/Documentation/accounting/psi.rst
@@ -81,12 +81,12 @@ desired threshold and time window. The open file descriptor should be
 used to wait for trigger events using select(), poll() or epoll().
 The following format is used::
 
-	<some|full> <stall amount in us> <time window in us>
+<some|full> <min stall amount in us> <max stall amount in us> <time window in us>
 
-For example writing "some 150000 1000000" into /proc/pressure/memory
-would add 150ms threshold for partial memory stall measured within
-1sec time window. Writing "full 50000 1000000" into /proc/pressure/io
-would add 50ms threshold for full io stall measured within 1sec time window.
+For example writing "some 150000 350000 1000000" into /proc/pressure/memory
+would add 150ms ~ 350ms threshold for partial memory stall measured within
+1sec time window. Writing "full 50000 70000 1000000" into /proc/pressure/io
+would add 50ms ~ 70ms threshold for full io stall measured within 1sec time window.
 
 Triggers can be set on more than one psi metric and more than one trigger
 for the same psi metric can be specified. However for each trigger a separate
@@ -132,7 +132,7 @@ Userspace monitor usage example
    * and 150ms threshold.
    */
   int main() {
-	const char trig[] = "some 150000 1000000";
+	const char trig[] = "some 150000 350000 1000000";
 	struct pollfd fds;
 	int n;
 
diff --git a/Documentation/translations/zh_CN/accounting/psi.rst b/Documentation/translations/zh_CN/accounting/psi.rst
index a0ddb7bd257c..9e8f6467e034 100644
--- a/Documentation/translations/zh_CN/accounting/psi.rst
+++ b/Documentation/translations/zh_CN/accounting/psi.rst
@@ -69,11 +69,12 @@ avg代表阻塞时间占比（百分比），为最近10秒、60秒、300秒内
 所打开的文件描述符用于等待事件，可使用select()、poll()、epoll()。
 写入信息的格式如下：
 
-        <some|full> <stall amount in us> <time window in us>
+        <some|full> <min stall amount in us> <max stall amount in us> <time window in us>
 
-示例：向/proc/pressure/memory写入"some 150000 1000000"将新增触发器，将在
-1秒内至少一个任务阻塞于内存的总时间超过150ms时触发。向/proc/pressure/io写入
-"full 50000 1000000"将新增触发器，将在1秒内所有任务都阻塞于io的总时间超过50ms时触发。
+示例：向/proc/pressure/memory写入"some 150000 350000, 1000000"将新增触发器，将在
+1秒内至少一个任务阻塞于内存的总时间在150ms ~ 350ms时触发。向/proc/pressure/io写入
+"full 50000 70000 1000000"将新增触发器，将在1秒内所有任务都阻塞于io的总时间在50ms ~ 70ms
+时触发。
 
 触发器可针对多个psi度量值设置，同一个psi度量值可设置多个触发器。每个触发器需要
 单独的文件描述符用于轮询，以区分于其他触发器。所以即使对于同一个psi接口文件，
@@ -105,7 +106,7 @@ psi接口提供的均值即可。
 
   /* 监控内存部分阻塞，监控时间窗口为1秒、阻塞门限为150毫秒。*/
   int main() {
-        const char trig[] = "some 150000 1000000";
+        const char trig[] = "some 150000 350000 1000000";
         struct pollfd fds;
         int n;
 
-- 
2.25.1