From: Doehyun Baek <doehyunbaek@gmail.com>
To: Alex Shi <alexs@kernel.org>, Yanteng Si <si.yanteng@linux.dev>
Cc: Dongliang Mu <dzm91@hust.edu.cn>, SJ Park <sj@kernel.org>,
Jonathan Corbet <corbet@lwn.net>,
Shuah Khan <skhan@linuxfoundation.org>,
damon@lists.linux.dev, linux-mm@kvack.org,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
Doehyun Baek <doehyunbaek@gmail.com>
Subject: [PATCH v6 6/7] docs/zh_CN: update DAMON reclaim translation
Date: Wed, 8 Jul 2026 07:32:45 +0000 [thread overview]
Message-ID: <20260708073246.1652828-7-doehyunbaek@gmail.com> (raw)
In-Reply-To: <20260708073246.1652828-1-doehyunbaek@gmail.com>
Update the Chinese translation of .../admin-guide/mm/damon/reclaim.rst.
Update the translation through commit c9380cdd949d
("Docs/{admin-guide,mm}/damon: fix DAMON documentation details").
Signed-off-by: Doehyun Baek <doehyunbaek@gmail.com>
---
.../zh_CN/admin-guide/mm/damon/reclaim.rst | 82 ++++++++++++++++++-
1 file changed, 80 insertions(+), 2 deletions(-)
diff --git a/Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst b/Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst
index d14ba32f7788..1e9375947295 100644
--- a/Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst
+++ b/Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst
@@ -58,6 +58,19 @@ enabled
DAMON_RECLAIM。注意,由于基于水位的激活条件,DAMON_RECLAIM不能进行真正的监测和回收。
这一点请参考下面关于水位参数的描述。
+commit_inputs
+-------------
+
+让 DAMON_RECLAIM 再次读取除 ``enabled`` 外的输入参数。
+
+DAMON_RECLAIM 运行期间更新的输入参数默认不会应用。一旦该参数被设置为
+``Y``,DAMON_RECLAIM 会再次读取除 ``enabled`` 外的参数值。重新读取完成后,
+该参数会被设置为 ``N``。如果重新读取时发现无效参数,DAMON_RECLAIM 会被
+禁用。
+
+一旦向该参数写入 ``Y``,用户在再次读取 ``commit_inputs`` 返回 ``N`` 之前,
+不得写入任何参数。如果用户违反该规则,内核可能表现出未定义行为。
+
min_age
-------
@@ -68,6 +81,15 @@ min_age
默认为120秒。
+autotune_monitoring_intervals
+-----------------------------
+
+如果该参数设置为 ``Y``,DAMON_RECLAIM 会自动调优 DAMON 的采样和聚集间隔。
+自动调优的目标是在每个 DAMON 快照中捕获有意义数量的访问事件,同时将采样
+间隔限制在最小 5 毫秒、最大 10 秒。将其设置为 ``N`` 会禁用自动调优。
+
+默认禁用。
+
quota_ms
--------
@@ -98,6 +120,29 @@ quota_reset_interval_ms
默认为1秒。
+quota_mem_pressure_us
+---------------------
+
+期望的内存压力停滞时间水平,单位为微秒。
+
+在保持其他配额设置的上限的同时,DAMON_RECLAIM 会自动增减配额的有效水平,
+目标是产生该水平的内存压力。系统范围的 ``some`` 内存 PSI 会按每个配额重置
+间隔(``quota_reset_interval_ms``)以微秒为单位收集,并与该值比较,以判断
+目标是否满足。值为零表示禁用该自动调优功能。
+
+默认禁用。
+
+quota_autotune_feedback
+-----------------------
+
+用户可指定的有效配额自动调优反馈。
+
+在保持其他配额设置的上限的同时,DAMON_RECLAIM 会自动增减配额的有效水平,
+目标是从用户接收到值为 ``10,000`` 的反馈。DAMON_RECLAIM 假定反馈值和配额
+成正比。值为零表示禁用该自动调优功能。
+
+默认禁用。
+
wmarks_interval
---------------
@@ -149,6 +194,8 @@ min_nr_regions
DAMON用于冷内存监测的最小监测区域数。这可以用来设置监测质量的下限。但是,设
置的太高可能会导致监测开销的增加。更多细节请参考DAMON文档 (:doc:`usage`) 。
+请注意,该值必须为 3 或更高。该下限的理由请参考设计文档的 :ref:`监测 <damon_design_monitoring_zh_CN>` 章节。
+
max_nr_regions
--------------
@@ -163,7 +210,7 @@ monitor_region_start
目标内存区域的物理地址起点。
DAMON_RECLAIM将对其进行工作的内存区域的起始物理地址。也就是说,DAMON_RECLAIM
-将在这个区域中找到冷的内存区域并进行回收。默认情况下,该区域使用最大系统内存区。
+将在这个区域中找到冷的内存区域并进行回收。默认情况下,该区域使用系统的整个物理内存。
monitor_region_end
------------------
@@ -171,7 +218,35 @@ monitor_region_end
目标内存区域的结束物理地址。
DAMON_RECLAIM将对其进行工作的内存区域的末端物理地址。也就是说,DAMON_RECLAIM将
-在这个区域内找到冷的内存区域并进行回收。默认情况下,该区域使用最大系统内存区。
+在这个区域内找到冷的内存区域并进行回收。默认情况下,该区域使用系统的整个物理内存。
+
+addr_unit
+---------
+
+内存地址和字节数的缩放因子。
+
+该参数用于设置和获取 DAMON_RECLAIM 的 DAMON 实例的 :ref:`地址单位 <damon_design_addr_unit_zh_CN>` 参数。
+
+``monitor_region_start`` 和 ``monitor_region_end`` 应以该单位提供。例如,
+假设 ``addr_unit``、``monitor_region_start`` 和 ``monitor_region_end``
+分别设置为 ``1024``、``0`` 和 ``10``。那么 DAMON_RECLAIM 将处理从地址零
+开始、长度为 10 KiB 的物理地址范围(以字节表示为
+``[0 * 1024, 10 * 1024)``)。
+
+``bytes_reclaim_tried_regions`` 和 ``bytes_reclaimed_regions`` 也使用该单位。
+例如,假设 ``addr_unit``、``bytes_reclaim_tried_regions`` 和
+``bytes_reclaimed_regions`` 的值分别为 ``1024``、``42`` 和 ``32``。那么这
+表示 DAMON_RECLAIM 总共尝试回收 42 KiB 内存,并成功回收了 32 KiB 内存。
+
+如果不确定,只使用默认值(``1``)并忘记这个参数即可。
+
+skip_anon
+---------
+
+跳过匿名页回收。
+
+如果该参数设置为 ``Y``,DAMON_RECLAIM 不会回收匿名页。默认值为 ``N``。
+
kdamond_pid
-----------
@@ -223,6 +298,9 @@ DAMON_RECLAIM再次什么都不做,这样我们就可以退回到基于LRU列
# echo 200 > wmarks_low
# echo Y > enabled
+请注意,该模块(damon_reclaim)不能与其他基于 DAMON 的专用模块同时运行。
+更多细节请参考 :ref:`DAMON 设计文档的专用模块互斥性 <damon_design_special_purpose_modules_exclusivity_zh_CN>`。
+
.. [1] https://research.google/pubs/pub48551/
.. [2] https://lwn.net/Articles/787611/
.. [3] https://www.kernel.org/doc/html/latest/mm/free_page_reporting.html
--
2.43.0
next prev parent reply other threads:[~2026-07-08 7:33 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-08 7:32 [PATCH v6 0/7] docs/zh_CN: update DAMON translations Doehyun Baek
2026-07-08 7:32 ` [PATCH v6 1/7] docs/zh_CN: update DAMON design translation Doehyun Baek
2026-07-08 7:32 ` [PATCH v6 2/7] docs/zh_CN: add DAMON_STAT usage translation Doehyun Baek
2026-07-08 7:32 ` [PATCH v6 3/7] docs/zh_CN: update DAMON index translation Doehyun Baek
2026-07-08 7:32 ` [PATCH v6 4/7] docs/zh_CN: update DAMON start translation Doehyun Baek
2026-07-08 7:32 ` [PATCH v6 5/7] docs/zh_CN: update DAMON usage translation Doehyun Baek
2026-07-08 7:32 ` Doehyun Baek [this message]
2026-07-08 7:32 ` [PATCH v6 7/7] docs/zh_CN: update DAMON LRU sort translation Doehyun Baek
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=20260708073246.1652828-7-doehyunbaek@gmail.com \
--to=doehyunbaek@gmail.com \
--cc=alexs@kernel.org \
--cc=corbet@lwn.net \
--cc=damon@lists.linux.dev \
--cc=dzm91@hust.edu.cn \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=si.yanteng@linux.dev \
--cc=sj@kernel.org \
--cc=skhan@linuxfoundation.org \
/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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox