docs/zh_CN: add admin-guide damon translation
Subsystems (2)
v4 cover docs/zh_CN: add admin-guide damon translation
v4:
* Build test in next-20220307.
* My patch thread is based on
<https://lore.kernel.org/linux-doc/[email protected]/T/#t>
v3:
* Build test in next-20220304.
v2:
* Pick Alexs Reviewed-by tag. [PATCH 1-3/5]
* Fix a build warning.(introduce from usage.rst)
v1:
* Translate .../admin-guide/mm/damon/* into Chinese
* note my patch thread is based on
<https://lore.kernel.org/linux-doc/[email protected]/T/#t>
Yanteng Si (5):
docs/zh_CN: Refactoring the admin-guide directory index docs/zh_CN: add admin-guide damon index translation docs/zh_CN: add admin-guide damon start translation docs/zh_CN: add damon usage translation docs/zh_CN: add damon reclaim translation
.../translations/zh_CN/admin-guide/index.rst | 122 ++++---- .../zh_CN/admin-guide/mm/damon/index.rst | 28 ++ .../zh_CN/admin-guide/mm/damon/reclaim.rst | 232 ++++++++++++++ .../zh_CN/admin-guide/mm/damon/start.rst | 132 ++++++++ .../zh_CN/admin-guide/mm/damon/usage.rst | 286 ++++++++++++++++++ .../zh_CN/admin-guide/mm/index.rst | 2 +- 6 files changed, 740 insertions(+), 62 deletions(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/index.rst create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst
Signature · 1 line
2.27.0
PATCH v4 1/5 docs/zh_CN: Refactoring the admin-guide directory index
From: Yanteng Si <[email protected]>
The Todolist in the html document looks a mess, now give it a nice looking format.
--- .../translations/zh_CN/admin-guide/index.rst | 122 +++++++++--------- 1 file changed, 61 insertions(+), 61 deletions(-)
Documentation/translations/zh_CN/admin-guide/index.rst +61 -61
@@ -20,15 +20,15 @@ Linux 内核用户和管理员指南 Todolist: - kernel-parameters - devices - sysctl/index +* kernel-parameters +* devices +* sysctl/index 本节介绍CPU漏洞及其缓解措施。 Todolist: - hw-vuln/index +* hw-vuln/index 下面的一组文档,针对的是试图跟踪问题和bug的用户。
@@ -44,18 +44,18 @@ Todolist: Todolist: - reporting-bugs - ramoops - dynamic-debug-howto - kdump/index - perf/index +* reporting-bugs +* ramoops +* dynamic-debug-howto +* kdump/index +* perf/index 这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个 方面的文档。 Todolist: - sysfs-rules +* sysfs-rules 本手册的其余部分包括各种指南,介绍如何根据您的喜好配置内核的特定行为。
@@ -73,57 +73,57 @@ Todolist: Todolist: - acpi/index - aoe/index - auxdisplay/index - bcache - binderfs - binfmt-misc - blockdev/index - bootconfig - braille-console - btmrvl - cgroup-v1/index - cgroup-v2 - cifs/index - dell_rbu - device-mapper/index - edid - efi-stub - ext4 - nfs/index - gpio/index - highuid - hw_random - initrd - iostats - java - jfs - kernel-per-CPU-kthreads - laptops/index - lcd-panel-cgram - ldm - LSM/index - md - media/index - module-signing - mono - namespaces/index - numastat - parport - perf-security - pm/index - pnp - rapidio - ras - rtc - serial-console - svga - thunderbolt - ufs - vga-softcursor - video-output - xfs +* acpi/index +* aoe/index +* auxdisplay/index +* bcache +* binderfs +* binfmt-misc +* blockdev/index +* bootconfig +* braille-console +* btmrvl +* cgroup-v1/index +* cgroup-v2 +* cifs/index +* dell_rbu +* device-mapper/index +* edid +* efi-stub +* ext4 +* nfs/index +* gpio/index +* highuid +* hw_random +* initrd +* iostats +* java +* jfs +* kernel-per-CPU-kthreads +* laptops/index +* lcd-panel-cgram +* ldm +* LSM/index +* md +* media/index +* module-signing +* mono +* namespaces/index +* numastat +* parport +* perf-security +* pm/index +* pnp +* rapidio +* ras +* rtc +* serial-console +* svga +* thunderbolt +* ufs +* vga-softcursor +* video-output +* xfs .. only:: subproject and html
Signature · 1 line
2.27.0
PATCH v4 2/5 docs/zh_CN: add admin-guide damon index translation
In reply to Yanteng SiFrom: Yanteng Si <[email protected]>
Translate .../admin-guide/mm/damon/index.rst into Chinese.
--- .../zh_CN/admin-guide/mm/damon/index.rst | 26 +++++++++++++++++++ .../zh_CN/admin-guide/mm/index.rst | 2 +- 2 files changed, 27 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/index.rst
Documentation/translations/zh_CN/admin-guide/mm/damon/index.rst new file +26 -0
@@ -0,0 +1,26 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../../disclaimer-zh_CN.rst + +:Original: Documentation/admin-guide/mm/damon/index.rst + +:翻译: + + 司延腾 Yanteng Si <[email protected]> + +:校译: + +============ +监测数据访问 +============ + +:doc:`DAMON </vm/damon/index>` 允许轻量级的数据访问监测。使用DAMON, +用户可以分析他们系统的内存访问模式,并优化它们。 + +.. toctree:: + :maxdepth: 2 + +Todolist: + +* start +* usage +* reclaim
Documentation/translations/zh_CN/admin-guide/mm/index.rst +1 -1
@@ -29,12 +29,12 @@ Linux内存管理有它自己的术语,如果你还不熟悉它,请考虑阅 .. toctree:: :maxdepth: 1 + damon/index ksm Todolist: * concepts * cma_debugfs -* damon/index * hugetlbpage * idle_page_tracking * memory-hotplug
Signature · 1 line
2.27.0
PATCH v4 3/5 docs/zh_CN: add admin-guide damon start translation
In reply to Yanteng SiFrom: Yanteng Si <[email protected]>
Translate Documentation/admin-guide/mm/damon/start.rst into Chinese.
--- .../zh_CN/admin-guide/mm/damon/index.rst | 4 +- .../zh_CN/admin-guide/mm/damon/start.rst | 132 ++++++++++++++++++ 2 files changed, 135 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst
Documentation/translations/zh_CN/admin-guide/mm/damon/index.rst +3 -1
@@ -19,8 +19,10 @@ .. toctree:: :maxdepth: 2 + start + Todolist: -* start + * usage * reclaim
Documentation/translations/zh_CN/admin-guide/mm/damon/start.rst new file +132 -0
132 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v4 4/5 docs/zh_CN: add damon usage translation
In reply to Yanteng SiFrom: Yanteng Si <[email protected]>
Translate .../admin-guide/mm/damon/usage.rst into Chinese.
--- .../zh_CN/admin-guide/mm/damon/index.rst | 2 +- .../zh_CN/admin-guide/mm/damon/usage.rst | 286 ++++++++++++++++++ 2 files changed, 287 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst
Documentation/translations/zh_CN/admin-guide/mm/damon/index.rst +1 -1
@@ -20,9 +20,9 @@ :maxdepth: 2 start + usage Todolist: -* usage * reclaim
Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst new file +286 -0
286 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v4 5/5 docs/zh_CN: add damon reclaim translation
In reply to Yanteng SiFrom: Yanteng Si <[email protected]>
Translate .../admin-guide/mm/damon/reclaim.rst into Chinese.
--- .../zh_CN/admin-guide/mm/damon/index.rst | 4 +- .../zh_CN/admin-guide/mm/damon/reclaim.rst | 232 ++++++++++++++++++ 2 files changed, 234 insertions(+), 2 deletions(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst
Documentation/translations/zh_CN/admin-guide/mm/damon/index.rst +2 -2
@@ -21,8 +21,8 @@ start usage + reclaim + -Todolist: -* reclaim
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +232 -0
232 lines not on this page · raw message
Signature · 1 line
2.27.0
Re: [PATCH v4 5/5] docs/zh_CN: add damon reclaim translation
Quoted 44 lines · Yanteng Si
From: Yanteng Si <[email protected]>
Translate
.../admin-guide/mm/damon/reclaim.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>Reviewed-by Alex Shi <[email protected]>--- .../zh_CN/admin-guide/mm/damon/index.rst | 4 +- .../zh_CN/admin-guide/mm/damon/reclaim.rst | 232 ++++++++++++++++++ 2 files changed, 234 insertions(+), 2 deletions(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rstDocumentation/translations/zh_CN/admin-guide/mm/damon/index.rst +2
-2@@ -21,8 +21,8 @@ start usage + reclaim + -Todolist: -* reclaimDocumentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +10
-0@@ -0,0 +1,232 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../../disclaimer-zh_CN.rst + +:Original: Documentation/admin-guide/mm/damon/reclaim.rst + +:翻译: + + 司延腾 Yanteng Si <[email protected]> + +:校译:
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 20
Quoted 10 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +10
-0+ +=============== +基于DAMON的回收 +=============== + +基于DAMON的回收(DAMON_RECLAIM)是一个静态的内核模块,旨在用于轻度内存压力下的主动和轻 +量级的回收。它的目的不是取代基于LRU列表的页面回收,而是有选择地用于不同程度的内存压力和要 +求。 + +哪些地方需要主动复回收?
change to: 哪些地方需要主动回收?
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 23
Quoted 3 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +3
-0+======================== + +在一般的内存过度分配(over-committed systems,虚拟化相关术语)的系统上,主动回收冷页
overcommit - 超量使用 or 超卖?
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 28
Quoted 5 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +5
-0+有助于节省内存和减少延迟高峰,这些延迟是由直接回收进程或kswapd的CPU消耗引起的,同时只产 +生最小的性能下降 [1]_ [2]_ 。 + +基于空闲页报告 [3]_ 的内存过度承诺的虚拟化系统就是很好的例子。在这样的系统中,客户虚拟机 +向主机报告他们的空闲内存,而主机则将报告的内存重新分配给其他客户。因此,系统的内存得到了充
The original doc ommits gusts (VMs) in many place, but in Chinese, better to add back a short word, 客户机?
Quoted 18 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +18
-0+分的利用。然而,客户可能不那么节省内存,主要是因为一些内核子系统和用户空间应用程序被设计为 +使用尽可能多的内存。然后,客户可能只向主机报告少量的内存是空闲的,导致系统的内存利用率下降。 +在客户中运行主动回收可以缓解这个问题。 + +它是如何工作的? +================ + +DAMON_RECLAIM找到在特定时间内没有被访问的内存区域并分页。为了避免它在分页操作中消耗过多 +的CPU,可以配置一个速度限制。在这个速度限制下,它首先分页出那些没有被访问过的内存区域。系 +统管理员还可以配置在什么情况下这个方案应该自动激活和停用三个内存压力水位。 + +接口: 模块参数 +============== + +要使用这个功能,你首先要确保你的系统运行在一个以 ``CONFIG_DAMON_RECLAIM=y`` 构建的内 +核上。 + +为了让系统管理员启用或禁用它,并为给定的系统进行调整,DAMON_RECLAIM利用了模块参数。也就
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 56
Quoted 10 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +10
-0+是说,你可以把 ``damon_reclaim.<parameter>=<value>`` 放在内核启动命令行上,或者把 +适当的值写入 ``/sys/modules/damon_reclaim/parameters/<parameter>`` 文件。 + +注意,除 ``启用`` 外的参数值只在DAMON_RECLAIM启动时应用。因此,如果你想在运行时应用新 +的参数值,而DAMON_RECLAIM已经被启用,你应该通过 ``启用`` 的参数文件禁用和重新启用它。 +在重新启用之前,应将新的参数值写入适当的参数值中。 + +下面是每个参数的描述。 + +启用
as a parameter, better to use original word: enabled?
Quoted 35 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +35
-0+---- + +启用或禁用DAMON_RECLAIM。 + +你可以通过把这个参数的值设置为 ``Y`` 来启用DAMON_RCLAIM,把它设置为 ``N`` 可以禁用 +DAMON_RECLAIM。注意,由于基于水位的激活条件,DAMON_RECLAIM不能进行真正的监测和回收。 +这一点请参考下面关于水位参数的描述。 + +min_age +------- + +识别冷内存区域的时间阈值,单位是微秒。 + +如果一个内存区域在这个时间或更长的时间内没有被访问,DAMON_RECLAIM会将该区域识别为冷的, +并回收它。 + +默认为120秒。 + +quota_ms +-------- + +回收的时间限制,以毫秒为单位。 + +DAMON_RECLAIM 试图在一个时间窗口(quota_reset_interval_ms)内只使用到这个时间,以 +尝试回收冷页。这可以用来限制DAMON_RECLAIM的CPU消耗。如果该值为零,则该限制被禁用。 + +默认为10ms。 + +quota_sz +-------- + +回收的内存大小限制,单位为字节。 + +DAMON_RECLAIM 收取在一个时间窗口(quota_reset_interval_ms)内试图回收的内存量,并 +使其不超过这个限制。这可以用来限制CPU和IO的消耗。如果该值为零,则限制被禁用。
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 101
Quoted 10 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +10
-0+ +默认情况下是128 MiB。 + +quota_reset_interval_ms +----------------------- + +时间/大小配额收取重置间隔,单位为毫秒。 + +时间(quota_ms)和大小(quota_sz)的配额的目标重置间隔。也就是说,DAMON_RECLAIM在 +quota_ms毫秒内不尝试回收超过quota_ms毫秒或quota_sz字节。
尝试回收‘不’超过quota_ms毫秒或quota_sz字节的内存。
Quoted 59 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +59
-0+ +默认为1秒。 + +wmarks_interval +--------------- + +当DAMON_RECLAIM被启用但由于其水位规则而不活跃时,在检查水位之前的最小等待时间。 + +wmarks_high +----------- + +高水位的可用内存率(每千字节)。 + +如果系统的可用内存(以每千字节为单位)高于这个数值,DAMON_RECLAIM就会变得不活跃,所以 +它什么也不做,只是定期检查水位。 + +wmarks_mid +---------- + +中间水位的可用内存率(每千字节)。 + +如果系统的空闲内存(以每千字节为单位)在这个和低水位线之间,DAMON_RECLAIM就会被激活, +因此开始监测和回收。 + +wmarks_low +---------- + +低水位的可用内存率(每千字节)。 + +如果系统的空闲内存(以每千字节为单位)低于这个数值,DAMON_RECLAIM就会变得不活跃,所以 +它除了定期检查水位外什么都不做。在这种情况下,系统会退回到基于LRU列表的页面粒度回收逻辑。 + +sample_interval +--------------- + +监测的采样间隔,单位是微秒。 + +DAMON用于监测冷内存的采样间隔。更多细节请参考DAMON文档 (:doc:`usage`) 。 + +aggr_interval +------------- + +监测的聚集间隔,单位是微秒。 + +DAMON对冷内存监测的聚集间隔。更多细节请参考DAMON文档 (:doc:`usage`)。 + +min_nr_regions +-------------- + +监测区域的最小数量。 + +DAMON用于冷内存监测的最小监测区域数。这可以用来设置监测质量的下限。但是,设 +置的太高可能会导致监测开销的增加。更多细节请参考DAMON文档 (:doc:`usage`) 。 + +max_nr_regions +-------------- + +监测区域的最大数量。 +
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 170
Quoted 10 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +10
-0+DAMON用于冷内存监测的最大监测区域数。这可以用来设置监测开销的上限值。但是, +设置得太低可能会导致监测质量不好。更多细节请参考DAMON文档 (:doc:`usage`) 。 + +monitor_region_start +-------------------- + +目标内存区域的物理地址起点。 + +DAMON_RECLAIM将对其进行工作的内存区域的起始物理地址。也就是说,DAMON_RECLAIM +将在这个区域中找到冷的内存区域并进行回收。默认情况下,最大的系统RAM被用作该区域。
默认情况下,该区域使用最大系统内存区。
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 175
Quoted 5 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +5
-0+ +monitor_region_end +------------------ + +目标内存区域的物理地址结束。
目标内存区域的结束物理地址。
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 178
Quoted 3 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +3
-0+ +DAMON_RECLAIM将对其进行工作的内存区域的末端物理地址。也就是说,DAMON_RECLAIM将 +在这个区域内找到冷的内存区域并进行回收。默认情况下,最大的系统RAM被用作该区域。
ditto
Quoted 27 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +27
-0+ +kdamond_pid +----------- + +DAMON线程的PID。 + +如果DAMON_RECLAIM被启用,这将成为工作线程的PID。否则,为-1。 + +nr_reclaim_tried_regions +------------------------ + +试图通过DAMON_RECLAIM回收的内存区域的数量。 + +bytes_reclaim_tried_regions +--------------------------- + +试图通过DAMON_RECLAIM回收的内存区域的总字节数。 + +nr_reclaimed_regions +-------------------- + +通过DAMON_RECLAIM成功回收的内存区域的数量。 + +bytes_reclaimed_regions +----------------------- + +通过DAMON_RECLAIM成功回收的内存区域的总字节数。
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 215
Quoted 10 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +10
-0+ +nr_quota_exceeds +---------------- + +超过时间/空间配额限制的次数。 + +例子 +==== + +下面的运行示例命令使DAMON_RECLAIM找到30秒或更长时间没有访问的内存区域并分页出来。
下面的运行示例命令使DAMON_RECLAIM找到30秒或更长时间没有访问的内存区域并“回收”?
Quoted 20 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +17
-1+为了避免DAMON_RECLAIM在分页操作中消耗过多的CPU时间,回收被限制在每秒1GiB以内。 +它还要求DAMON_RECLAIM在系统的可用内存率超过50%时不做任何事情,但如果它低于40%时 +就开始真正的工作。如果DAMON_RECLAIM没有取得进展,因此空闲内存率低于20%,它会要求 +DAMON_RECLAIM再次什么都不做,这样我们就可以退回到基于LRU列表的页面粒度回收了:: + + # cd /sys/modules/damon_reclaim/parameters + # echo 30000000 > min_age + # echo $((1 * 1024 * 1024 * 1024)) > quota_sz + # echo 1000 > quota_reset_interval_ms + # echo 500 > wmarks_high + # echo 400 > wmarks_mid + # echo 200 > wmarks_low + # echo Y > enabled + +.. [1] https://research.google/pubs/pub48551/ +.. [2] https://lwn.net/Articles/787611/ +.. [3] https://www.kernel.org/doc/html/latest/vm/free_page_reporting.html --2.27.0
Re: [PATCH v4 5/5] docs/zh_CN: add damon reclaim translation
Quoted 50 lines · Alex Shi <[email protected]> 于2022年3月9日周三 15:12写道:
Quoted 48 lines · Yanteng Si
From: Yanteng Si <[email protected]>
Translate
.../admin-guide/mm/damon/reclaim.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>Reviewed-by Alex Shi <[email protected]>--- .../zh_CN/admin-guide/mm/damon/index.rst | 4 +- .../zh_CN/admin-guide/mm/damon/reclaim.rst | 232 ++++++++++++++++++ 2 files changed, 234 insertions(+), 2 deletions(-) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rstDocumentation/translations/zh_CN/admin-guide/mm/damon/index.rst +2
-2@@ -21,8 +21,8 @@ start usage + reclaim + -Todolist: -* reclaimDocumentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +14
-0@@ -0,0 +1,232 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../../disclaimer-zh_CN.rst + +:Original: Documentation/admin-guide/mm/damon/reclaim.rst + +:翻译: + + 司延腾 Yanteng Si <[email protected]> + +:校译: + +=============== +基于DAMON的回收 +===============
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 20
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +6
-0+ +基于DAMON的回收(DAMON_RECLAIM)是一个静态的内核模块,旨在用于轻度内存压力下的主动和轻 +量级的回收。它的目的不是取代基于LRU列表的页面回收,而是有选择地用于不同程度的内存压力和要 +求。 + +哪些地方需要主动复回收?change to: 哪些地方需要主动回收?
ok,Thanks!
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 23
Quoted 4 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +3
-0+======================== + +在一般的内存过度分配(over-committed systems,虚拟化相关术语)的系统上,主动回收冷页overcommit - 超量使用 or 超卖?
use 超量使用
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 28
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +5
-0+有助于节省内存和减少延迟高峰,这些延迟是由直接回收进程或kswapd的CPU消耗引起的,同时只产 +生最小的性能下降 [1]_ [2]_ 。 + +基于空闲页报告 [3]_ 的内存过度承诺的虚拟化系统就是很好的例子。在这样的系统中,客户虚拟机 +向主机报告他们的空闲内存,而主机则将报告的内存重新分配给其他客户。因此,系统的内存得到了充The original doc ommits gusts (VMs) in many place, but in Chinese,
客户虚拟机 seems too wordy,I usually try to translate in detail where it first appears in an article, and will use short expressions below.
Quoted 1 line
better to add back a short word, 客户机?
客户机 is well.
Quoted 23 lines
Quoted 23 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +22
-0+分的利用。然而,客户可能不那么节省内存,主要是因为一些内核子系统和用户空间应用程序被设计为 +使用尽可能多的内存。然后,客户可能只向主机报告少量的内存是空闲的,导致系统的内存利用率下降。 +在客户中运行主动回收可以缓解这个问题。 + +它是如何工作的? +================ + +DAMON_RECLAIM找到在特定时间内没有被访问的内存区域并分页。为了避免它在分页操作中消耗过多 +的CPU,可以配置一个速度限制。在这个速度限制下,它首先分页出那些没有被访问过的内存区域。系 +统管理员还可以配置在什么情况下这个方案应该自动激活和停用三个内存压力水位。 + +接口: 模块参数 +============== + +要使用这个功能,你首先要确保你的系统运行在一个以 ``CONFIG_DAMON_RECLAIM=y`` 构建的内 +核上。 + +为了让系统管理员启用或禁用它,并为给定的系统进行调整,DAMON_RECLAIM利用了模块参数。也就 +是说,你可以把 ``damon_reclaim.<parameter>=<value>`` 放在内核启动命令行上,或者把 +适当的值写入 ``/sys/modules/damon_reclaim/parameters/<parameter>`` 文件。 + +注意,除 ``启用`` 外的参数值只在DAMON_RECLAIM启动时应用。因此,如果你想在运行时应用新
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 56
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +6
-0+的参数值,而DAMON_RECLAIM已经被启用,你应该通过 ``启用`` 的参数文件禁用和重新启用它。 +在重新启用之前,应将新的参数值写入适当的参数值中。 + +下面是每个参数的描述。 + +启用as a parameter, better to use original word: enabled?
OK,Enable.
Quoted 40 lines
Quoted 40 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +39
-0+---- + +启用或禁用DAMON_RECLAIM。 + +你可以通过把这个参数的值设置为 ``Y`` 来启用DAMON_RCLAIM,把它设置为 ``N`` 可以禁用 +DAMON_RECLAIM。注意,由于基于水位的激活条件,DAMON_RECLAIM不能进行真正的监测和回收。 +这一点请参考下面关于水位参数的描述。 + +min_age +------- + +识别冷内存区域的时间阈值,单位是微秒。 + +如果一个内存区域在这个时间或更长的时间内没有被访问,DAMON_RECLAIM会将该区域识别为冷的, +并回收它。 + +默认为120秒。 + +quota_ms +-------- + +回收的时间限制,以毫秒为单位。 + +DAMON_RECLAIM 试图在一个时间窗口(quota_reset_interval_ms)内只使用到这个时间,以 +尝试回收冷页。这可以用来限制DAMON_RECLAIM的CPU消耗。如果该值为零,则该限制被禁用。 + +默认为10ms。 + +quota_sz +-------- + +回收的内存大小限制,单位为字节。 + +DAMON_RECLAIM 收取在一个时间窗口(quota_reset_interval_ms)内试图回收的内存量,并 +使其不超过这个限制。这可以用来限制CPU和IO的消耗。如果该值为零,则限制被禁用。 + +默认情况下是128 MiB。 + +quota_reset_interval_ms
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 101
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +6
-0+----------------------- + +时间/大小配额收取重置间隔,单位为毫秒。 + +时间(quota_ms)和大小(quota_sz)的配额的目标重置间隔。也就是说,DAMON_RECLAIM在 +quota_ms毫秒内不尝试回收超过quota_ms毫秒或quota_sz字节。尝试回收‘不’超过quota_ms毫秒或quota_sz字节的内存。
OK!
Quoted 64 lines
Quoted 64 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +63
-0+ +默认为1秒。 + +wmarks_interval +--------------- + +当DAMON_RECLAIM被启用但由于其水位规则而不活跃时,在检查水位之前的最小等待时间。 + +wmarks_high +----------- + +高水位的可用内存率(每千字节)。 + +如果系统的可用内存(以每千字节为单位)高于这个数值,DAMON_RECLAIM就会变得不活跃,所以 +它什么也不做,只是定期检查水位。 + +wmarks_mid +---------- + +中间水位的可用内存率(每千字节)。 + +如果系统的空闲内存(以每千字节为单位)在这个和低水位线之间,DAMON_RECLAIM就会被激活, +因此开始监测和回收。 + +wmarks_low +---------- + +低水位的可用内存率(每千字节)。 + +如果系统的空闲内存(以每千字节为单位)低于这个数值,DAMON_RECLAIM就会变得不活跃,所以 +它除了定期检查水位外什么都不做。在这种情况下,系统会退回到基于LRU列表的页面粒度回收逻辑。 + +sample_interval +--------------- + +监测的采样间隔,单位是微秒。 + +DAMON用于监测冷内存的采样间隔。更多细节请参考DAMON文档 (:doc:`usage`) 。 + +aggr_interval +------------- + +监测的聚集间隔,单位是微秒。 + +DAMON对冷内存监测的聚集间隔。更多细节请参考DAMON文档 (:doc:`usage`)。 + +min_nr_regions +-------------- + +监测区域的最小数量。 + +DAMON用于冷内存监测的最小监测区域数。这可以用来设置监测质量的下限。但是,设 +置的太高可能会导致监测开销的增加。更多细节请参考DAMON文档 (:doc:`usage`) 。 + +max_nr_regions +-------------- + +监测区域的最大数量。 + +DAMON用于冷内存监测的最大监测区域数。这可以用来设置监测开销的上限值。但是, +设置得太低可能会导致监测质量不好。更多细节请参考DAMON文档 (:doc:`usage`) 。 + +monitor_region_start
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 170
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +6
-0+-------------------- + +目标内存区域的物理地址起点。 + +DAMON_RECLAIM将对其进行工作的内存区域的起始物理地址。也就是说,DAMON_RECLAIM +将在这个区域中找到冷的内存区域并进行回收。默认情况下,最大的系统RAM被用作该区域。默认情况下,该区域使用最大系统内存区。
ok.
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 175
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +5
-0+ +monitor_region_end +------------------ + +目标内存区域的物理地址结束。目标内存区域的结束物理地址。
ok.
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 178
Quoted 4 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +3
-0+ +DAMON_RECLAIM将对其进行工作的内存区域的末端物理地址。也就是说,DAMON_RECLAIM将 +在这个区域内找到冷的内存区域并进行回收。默认情况下,最大的系统RAM被用作该区域。ditto
ok.
Quoted 32 lines
Quoted 32 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +31
-0+ +kdamond_pid +----------- + +DAMON线程的PID。 + +如果DAMON_RECLAIM被启用,这将成为工作线程的PID。否则,为-1。 + +nr_reclaim_tried_regions +------------------------ + +试图通过DAMON_RECLAIM回收的内存区域的数量。 + +bytes_reclaim_tried_regions +--------------------------- + +试图通过DAMON_RECLAIM回收的内存区域的总字节数。 + +nr_reclaimed_regions +-------------------- + +通过DAMON_RECLAIM成功回收的内存区域的数量。 + +bytes_reclaimed_regions +----------------------- + +通过DAMON_RECLAIM成功回收的内存区域的总字节数。 + +nr_quota_exceeds +---------------- +
Quoted 8 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst line 215
Quoted 6 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +6
-0+超过时间/空间配额限制的次数。 + +例子 +==== + +下面的运行示例命令使DAMON_RECLAIM找到30秒或更长时间没有访问的内存区域并分页出来。下面的运行示例命令使DAMON_RECLAIM找到30秒或更长时间没有访问的内存区域并“回收”?
ok.
Thank you for your review!
Thanks,
Yanteng
Quoted 21 lines
Quoted 21 lines
Documentation/translations/zh_CN/admin-guide/mm/damon/reclaim.rst new file +17
-1+为了避免DAMON_RECLAIM在分页操作中消耗过多的CPU时间,回收被限制在每秒1GiB以内。 +它还要求DAMON_RECLAIM在系统的可用内存率超过50%时不做任何事情,但如果它低于40%时 +就开始真正的工作。如果DAMON_RECLAIM没有取得进展,因此空闲内存率低于20%,它会要求 +DAMON_RECLAIM再次什么都不做,这样我们就可以退回到基于LRU列表的页面粒度回收了:: + + # cd /sys/modules/damon_reclaim/parameters + # echo 30000000 > min_age + # echo $((1 * 1024 * 1024 * 1024)) > quota_sz + # echo 1000 > quota_reset_interval_ms + # echo 500 > wmarks_high + # echo 400 > wmarks_mid + # echo 200 > wmarks_low + # echo Y > enabled + +.. [1] https://research.google/pubs/pub48551/ +.. [2] https://lwn.net/Articles/787611/ +.. [3] https://www.kernel.org/doc/html/latest/vm/free_page_reporting.html --2.27.0
Re: [PATCH v4 5/5] docs/zh_CN: add damon reclaim translation
Quoted 4 lines · yanteng si
Quoted 3 lines
Quoted 1 line
+启用
as a parameter, better to use original word: enabled?
OK,Enable.
Hi Yanteng,
The word in original doc is: 'enabled', not 'Enable'. :)
Thanks
Re: [PATCH v4 5/5] docs/zh_CN: add damon reclaim translation
Quoted 10 lines · Alex Shi <[email protected]> 于2022年3月9日周三 20:48写道:
Quoted 4 lines · yanteng si
Quoted 3 lines
Quoted 1 line
+启用
as a parameter, better to use original word: enabled?
OK,Enable.
Hi Yanteng,
The word in original doc is: 'enabled', not 'Enable'. :)
Okey, enable. :)
Thanks,
Yanteng