[PATCH] docs/zh_CN: Add sched-debug Chinese translation

[PATCH] docs/zh_CN: Add sched-debug Chinese translation

[Tang Yizhou]

Translate scheduler/sched-debug.rst into Chinese.

Signed-off-by: Tang Yizhou <tangyizhou@huawei.com>
---
 .../translations/zh_CN/scheduler/index.rst    |  1 +
 .../zh_CN/scheduler/sched-debug.rst           | 51 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/scheduler/sched-debug.rst

diff --git a/Documentation/translations/zh_CN/scheduler/index.rst b/Documentation/translations/zh_CN/scheduler/index.rst
index 12bf3bd02ccf..5c0e07aee299 100644
--- a/Documentation/translations/zh_CN/scheduler/index.rst
+++ b/Documentation/translations/zh_CN/scheduler/index.rst
@@ -27,6 +27,7 @@ Linux调度器
     sched-energy
     sched-nice-design
     sched-stats
+    sched-debug
 
 TODOList:
 
diff --git a/Documentation/translations/zh_CN/scheduler/sched-debug.rst b/Documentation/translations/zh_CN/scheduler/sched-debug.rst
new file mode 100644
index 000000000000..5e17740c2bf3
--- /dev/null
+++ b/Documentation/translations/zh_CN/scheduler/sched-debug.rst
@@ -0,0 +1,51 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/scheduler/sched-debug.rst
+
+:翻译:
+
+  唐艺舟 Tang Yizhou <tangyeechou@gmail.com>
+
+=============
+调度器debugfs
+=============
+
+用配置项CONFIG_SCHED_DEBUG=y启动内核后，将可以访问/sys/kernel/debug/sched
+下的调度器专用调试文件。其中一些文件描述如下。
+
+numa_balancing
+==============
+
+`numa_balancing` 目录用来存放控制非统一内存访问（NUMA）平衡特性的相关文件。
+如果该特性导致系统负载太高，那么可以通过 `scan_period_min_ms, scan_delay_ms,
+scan_period_max_ms, scan_size_mb` 文件控制NUMA缺页的内核采样速率。
+
+
+scan_period_min_ms, scan_delay_ms, scan_period_max_ms, scan_size_mb
+-------------------------------------------------------------------
+
+自动NUMA平衡会扫描任务地址空间，检测页面是否被正确放置，或者数据是否应该被
+迁移到任务正在运行的本地内存结点，此时需解映射页面。每个“扫描延迟”（scan delay）
+时间之后，任务扫描其地址空间中下一批“扫描大小”（scan size）个页面。若抵达
+内存地址空间末尾，扫描器将从头开始重新扫描。
+
+结合来看，“扫描延迟”和“扫描大小”决定扫描速率。当“扫描延迟”减小时，扫描速率
+增加。“扫描延迟”和每个任务的扫描速率都是自适应的，且依赖历史行为。如果页面被
+正确放置，那么扫描延迟就会增加；否则扫描延迟就会减少。“扫描大小”不是自适应的，
+“扫描大小”越大，扫描速率越高。
+
+更高的扫描速率会产生更高的系统开销，因为必须捕获缺页异常，并且潜在地必须迁移
+数据。然而，当扫描速率越高，若工作负载模式发生变化，任务的内存将越快地迁移到
+本地结点，由于远程内存访问而产生的性能影响将降到最低。下面这些文件控制扫描延迟
+的阈值和被扫描的页面数量。
+
+``scan_period_min_ms`` 是扫描一个任务虚拟内存的最小时间，单位是毫秒。它有效地
+控制了每个任务的最大扫描速率。
+
+``scan_delay_ms`` 是一个任务初始化创建（fork）时，第一次使用的“扫描延迟”。
+
+``scan_period_max_ms`` 是扫描一个任务虚拟内存的最大时间，单位是毫秒。它有效地
+控制了每个任务的最小扫描速率。
+
+``scan_size_mb`` 是一次特定的扫描中，要扫描多少兆字节（MB）对应的页面数。
-- 
2.17.1

Re: [PATCH] docs/zh_CN: Add sched-debug Chinese translation

[yanteng si]

Tang Yizhou <tangyizhou@huawei.com> 于2022年3月17日周四 10:27写道：
>
> Translate scheduler/sched-debug.rst into Chinese.
>
> Signed-off-by: Tang Yizhou <tangyizhou@huawei.com>
Reviewed-by: Yanteng Si <siyanteng@loongson.cn>
> ---
>  .../translations/zh_CN/scheduler/index.rst    |  1 +
>  .../zh_CN/scheduler/sched-debug.rst           | 51 +++++++++++++++++++
>  2 files changed, 52 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/scheduler/sched-debug.rst
>
> diff --git a/Documentation/translations/zh_CN/scheduler/index.rst b/Documentation/translations/zh_CN/scheduler/index.rst
> index 12bf3bd02ccf..5c0e07aee299 100644
> --- a/Documentation/translations/zh_CN/scheduler/index.rst
> +++ b/Documentation/translations/zh_CN/scheduler/index.rst
> @@ -27,6 +27,7 @@ Linux调度器
>      sched-energy
>      sched-nice-design
>      sched-stats
> +    sched-debug
>
>  TODOList:
>
> diff --git a/Documentation/translations/zh_CN/scheduler/sched-debug.rst b/Documentation/translations/zh_CN/scheduler/sched-debug.rst
> new file mode 100644
> index 000000000000..5e17740c2bf3
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/scheduler/sched-debug.rst
> @@ -0,0 +1,51 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/scheduler/sched-debug.rst
> +
> +:翻译:
> +
> +  唐艺舟 Tang Yizhou <tangyeechou@gmail.com>
> +
> +=============
> +调度器debugfs
> +=============
> +
> +用配置项CONFIG_SCHED_DEBUG=y启动内核后，将可以访问/sys/kernel/debug/sched
> +下的调度器专用调试文件。其中一些文件描述如下。
> +
> +numa_balancing
> +==============
> +
> +`numa_balancing` 目录用来存放控制非统一内存访问（NUMA）平衡特性的相关文件。
> +如果该特性导致系统负载太高，那么可以通过 `scan_period_min_ms, scan_delay_ms,
> +scan_period_max_ms, scan_size_mb` 文件控制NUMA缺页的内核采样速率。
> +
> +
> +scan_period_min_ms, scan_delay_ms, scan_period_max_ms, scan_size_mb
> +-------------------------------------------------------------------
> +
> +自动NUMA平衡会扫描任务地址空间，检测页面是否被正确放置，或者数据是否应该被
> +迁移到任务正在运行的本地内存结点，此时需解映射页面。每个“扫描延迟”（scan delay）
> +时间之后，任务扫描其地址空间中下一批“扫描大小”（scan size）个页面。若抵达
> +内存地址空间末尾，扫描器将从头开始重新扫描。
> +
> +结合来看，“扫描延迟”和“扫描大小”决定扫描速率。当“扫描延迟”减小时，扫描速率
> +增加。“扫描延迟”和每个任务的扫描速率都是自适应的，且依赖历史行为。如果页面被
> +正确放置，那么扫描延迟就会增加；否则扫描延迟就会减少。“扫描大小”不是自适应的，
> +“扫描大小”越大，扫描速率越高。
> +
> +更高的扫描速率会产生更高的系统开销，因为必须捕获缺页异常，并且潜在地必须迁移
> +数据。然而，当扫描速率越高，若工作负载模式发生变化，任务的内存将越快地迁移到
> +本地结点，由于远程内存访问而产生的性能影响将降到最低。下面这些文件控制扫描延迟
> +的阈值和被扫描的页面数量。
> +
> +``scan_period_min_ms`` 是扫描一个任务虚拟内存的最小时间，单位是毫秒。它有效地
> +控制了每个任务的最大扫描速率。
> +
> +``scan_delay_ms`` 是一个任务初始化创建（fork）时，第一次使用的“扫描延迟”。
> +
> +``scan_period_max_ms`` 是扫描一个任务虚拟内存的最大时间，单位是毫秒。它有效地
> +控制了每个任务的最小扫描速率。
> +
> +``scan_size_mb`` 是一次特定的扫描中，要扫描多少兆字节（MB）对应的页面数。
> --
> 2.17.1
>

Re: [PATCH] docs/zh_CN: Add sched-debug Chinese translation

[Alex Shi]

Reviewed-by: Alex Shi <alexs@kernel.org>

On Thu, Mar 17, 2022 at 10:27 AM Tang Yizhou <tangyizhou@huawei.com> wrote:
>
> Translate scheduler/sched-debug.rst into Chinese.
>
> Signed-off-by: Tang Yizhou <tangyizhou@huawei.com>
> ---
>  .../translations/zh_CN/scheduler/index.rst    |  1 +
>  .../zh_CN/scheduler/sched-debug.rst           | 51 +++++++++++++++++++
>  2 files changed, 52 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/scheduler/sched-debug.rst
>
> diff --git a/Documentation/translations/zh_CN/scheduler/index.rst b/Documentation/translations/zh_CN/scheduler/index.rst
> index 12bf3bd02ccf..5c0e07aee299 100644
> --- a/Documentation/translations/zh_CN/scheduler/index.rst
> +++ b/Documentation/translations/zh_CN/scheduler/index.rst
> @@ -27,6 +27,7 @@ Linux调度器
>      sched-energy
>      sched-nice-design
>      sched-stats
> +    sched-debug
>
>  TODOList:
>
> diff --git a/Documentation/translations/zh_CN/scheduler/sched-debug.rst b/Documentation/translations/zh_CN/scheduler/sched-debug.rst
> new file mode 100644
> index 000000000000..5e17740c2bf3
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/scheduler/sched-debug.rst
> @@ -0,0 +1,51 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/scheduler/sched-debug.rst
> +
> +:翻译:
> +
> +  唐艺舟 Tang Yizhou <tangyeechou@gmail.com>
> +
> +=============
> +调度器debugfs
> +=============
> +
> +用配置项CONFIG_SCHED_DEBUG=y启动内核后，将可以访问/sys/kernel/debug/sched
> +下的调度器专用调试文件。其中一些文件描述如下。
> +
> +numa_balancing
> +==============
> +
> +`numa_balancing` 目录用来存放控制非统一内存访问（NUMA）平衡特性的相关文件。
> +如果该特性导致系统负载太高，那么可以通过 `scan_period_min_ms, scan_delay_ms,
> +scan_period_max_ms, scan_size_mb` 文件控制NUMA缺页的内核采样速率。
> +
> +
> +scan_period_min_ms, scan_delay_ms, scan_period_max_ms, scan_size_mb
> +-------------------------------------------------------------------
> +
> +自动NUMA平衡会扫描任务地址空间，检测页面是否被正确放置，或者数据是否应该被
> +迁移到任务正在运行的本地内存结点，此时需解映射页面。每个“扫描延迟”（scan delay）
> +时间之后，任务扫描其地址空间中下一批“扫描大小”（scan size）个页面。若抵达
> +内存地址空间末尾，扫描器将从头开始重新扫描。
> +
> +结合来看，“扫描延迟”和“扫描大小”决定扫描速率。当“扫描延迟”减小时，扫描速率
> +增加。“扫描延迟”和每个任务的扫描速率都是自适应的，且依赖历史行为。如果页面被
> +正确放置，那么扫描延迟就会增加；否则扫描延迟就会减少。“扫描大小”不是自适应的，
> +“扫描大小”越大，扫描速率越高。
> +
> +更高的扫描速率会产生更高的系统开销，因为必须捕获缺页异常，并且潜在地必须迁移
> +数据。然而，当扫描速率越高，若工作负载模式发生变化，任务的内存将越快地迁移到
> +本地结点，由于远程内存访问而产生的性能影响将降到最低。下面这些文件控制扫描延迟
> +的阈值和被扫描的页面数量。
> +
> +``scan_period_min_ms`` 是扫描一个任务虚拟内存的最小时间，单位是毫秒。它有效地
> +控制了每个任务的最大扫描速率。
> +
> +``scan_delay_ms`` 是一个任务初始化创建（fork）时，第一次使用的“扫描延迟”。
> +
> +``scan_period_max_ms`` 是扫描一个任务虚拟内存的最大时间，单位是毫秒。它有效地
> +控制了每个任务的最小扫描速率。
> +
> +``scan_size_mb`` 是一次特定的扫描中，要扫描多少兆字节（MB）对应的页面数。
> --
> 2.17.1
>

Re: [PATCH] docs/zh_CN: Add sched-debug Chinese translation

[Jonathan Corbet]

Tang Yizhou <tangyizhou@huawei.com> writes:

> Translate scheduler/sched-debug.rst into Chinese.
>
> Signed-off-by: Tang Yizhou <tangyizhou@huawei.com>
> ---
>  .../translations/zh_CN/scheduler/index.rst    |  1 +
>  .../zh_CN/scheduler/sched-debug.rst           | 51 +++++++++++++++++++
>  2 files changed, 52 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/scheduler/sched-debug.rst

Applied, thanks.

jon