Re: [PATCH] docs/zh_CN: Add zh_CN/admin-guide/lockup-watchdogs.rst

[teng sterling]

CC siyanteng@xxxxxxxxxxx

BTW：

I don't know why, but your email was treated as spam by gmail. I use
gmail email to subscribe to doc-list, so I didn't find it before,
maybe many people are like me. :-)

Hailong Liu <liuhailongg6@xxxxxxx> 于2021年5月13日周四 下午11:45写道：
>
> From: Hailong Liu <liu.hailong6@xxxxxxxxxx>
>
> Add translation zh_CN/admin-guide/lockup-watchdogs.rst and link it to
> zh_CN/admin-guide/index.rst while clean its todo entry.
>
> Signed-off-by: Hailong Liu <liu.hailong6@xxxxxxxxxx>
> ---
>  .../translations/zh_CN/admin-guide/index.rst  |  2 +-
>  .../zh_CN/admin-guide/lockup-watchdogs.rst    | 65 +++++++++++++++++++
>  2 files changed, 66 insertions(+), 1 deletion(-)
>  create mode 100644 Documentation/translations/zh_CN/admin-guide/lockup-watchdogs.rst
>
> diff --git a/Documentation/translations/zh_CN/admin-guide/index.rst b/Documentation/translations/zh_CN/admin-guide/index.rst
> index be835ec8e632..460034cbc2ab 100644
> --- a/Documentation/translations/zh_CN/admin-guide/index.rst
> +++ b/Documentation/translations/zh_CN/admin-guide/index.rst
> @@ -65,6 +65,7 @@ Todolist:
>
>     clearing-warn-once
>     cpu-load
> +   lockup-watchdogs
>     unicode
>
>  Todolist:
> @@ -100,7 +101,6 @@ Todolist:
>     laptops/index
>     lcd-panel-cgram
>     ldm
> -   lockup-watchdogs
>     LSM/index
>     md
>     media/index
> diff --git a/Documentation/translations/zh_CN/admin-guide/lockup-watchdogs.rst b/Documentation/translations/zh_CN/admin-guide/lockup-watchdogs.rst
> new file mode 100644
> index 000000000000..1dd1e8061781
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/admin-guide/lockup-watchdogs.rst
> @@ -0,0 +1,65 @@
refer to other Chinese translations, add maintainer information and
tags and original documentation links.

> +===============================================================
> +Softlockup与hardlockup检测机制(又名:nmi_watchdog)
> +===============================================================
the line is too long，align it with the text

> +
> +Linux中内核实现了一种用以检测系统发生softlockup和hardlockup的
> +看门狗机制。
> +
> +Softlockup是一种在内核持续循使用CPU超过20秒（详见下面“实现”小节）
origindoc: A ‘softlockup’ is defined as a bug that causes the kernel
to loop in kernel mode for more than 20 seconds

It's not right for you to translate it that way. Although there are
not many cases where the kernel uses the cpu continuously for more
than 20s, it doesn't mean it doesn't exist, let alone conclude that it
will definitely panic.

btw：

bug：计算机领域专业术语，bug原意是“臭虫”，现在用来指代计算机上存在的漏洞，原因是系统安全策略上存在的缺陷，有攻击者能够在未授权的情况下访问的危害。
> +导致其他任务无法得到运行的内核问题。一旦检测到'softlockup'发生，默认
> +情况下系统会打印当前堆栈跟踪信息并进入锁定状态。也可配置使其在检测到
> +'softlockup'后进入panic状态；通过sysctl命令设置
> +“kernel.softlockup_panic”、使用内核启动参数“softlockup_panic”（详见
> +Documentation/admin-guide/kernel-parameters.rst）以及使能内核编译选项
> +“BOOTPARAM_SOFTLOCKUP_PANIC”都可实现这种配置。
> +
> +而'hardlockup'是内核中持续循环超过10秒钟（详见"实现"小节）导致其他中
maybe 内核态？

> +断无法运行的问题。与'softlockup'情况类似，除了使用sysctl命令设置
不给其他中断运行的机会 != 其他中断无法运行

> +'hardlockup_panic'、使能内核选项“BOOTPARAM_HARDLOCKUP_PANIC”以及使用
> +内核参数"nmi_watchdog"(详见:
> +”Documentation/admin-guide/kernel-parameters.rst“)外，一旦检测到
> +'hardlockup'默认情况下系统打印当前堆栈跟踪信息，然后进入锁定状态。
> +
> +这个panic选项也可以与panic_timeout结合使用（这个panic_timeout是通过稍
> +具迷惑性的sysctl命令"kernel.panic"来设置），使系统在panic指定时间后自
> +动重启。
> +
> +实现
> +==============
> +
> +Softlockup和hardlockup分别建立hrtimer(高精度定时器)和perf两个子系统上
> +而实现。这也就意味着理论上任何架构只要实现了这两个子系统就支持这两种
> +检测机制。
> +
> +Hrtimer用于周期性产生中断并唤醒watchdog任务；而NMI perf事件则以
> +”watchdog_thresh“(编译时默认初始化为10秒，也可通过”watchdog_thresh“这
> +个sysctl接口来进行配置修改)为间隔周期产生以检测 hardlockups。如果一个
> +CPU在这个时间段内没有检测到hrtimer中断发生，'hardlockup 检测器'(即
> +NMI perf事件处理函数)将会视系统配置而选择产生内核告警或者直接panic。
内核警告
> +
> +而watchdog任务本质上是一个高优先级内核线程，每调度一次就对时间戳进行一
> +次更新。如果在时间戳在2*watchdog_thresh秒(这个是softlockup的触发门限)
> +都未更新那么"softlocup 检测器"(内部hrtimer定时器回调函数)会将相关的调试
> +信息打印到系统日志中，然后如果系统配置了进入panic流程则进入panic，否则
> +内核继续执行。
> +
> +Hrtimer定时器的周期是2*watchdog_thresh/5，也就是说在hardlockup被触发前
> +hrtimer有2~3次机会产生时钟中断。
> +
> +如上所述,内核相当于为系统管理员提供了一个可调节hrtimer定时器和perf事件
> +的周期长短的旋钮。对于特定的场景通过这个旋钮配置一个合理的周期值需要权
> +衡lockups检测的响应速度和检测的开销。
> +
> +默认情况下所有在线cpu上都会运行一个watchdog任务。不过在内核配置了
maybe watchdog线程/进程？

> +”NO_HZ_FULL“的情况下watchdog默认只会运行在管家(housekeeping)cpu上，而
> +”nohz_full“启动参数指定的cpu上则不会有watchdog任务运行。想象一下，如果
> +我们允许watchdog任务在”nohz_full“指定的cpu上运行，这些cpu上必须得运行时
> +钟定时器来激发watchdog任务调度；这样一来就会使”nohz_full“保护用户程序免
> +受内核干扰的功能失效。当然，副作用就是”nohz_full“指定的cpu即使在内核产生
> +了lockup问题我们也无法检测到。不过，至少我们可以允许watchdog在管家
> +(non-tickless)核上继续运行以便我们能够继续正常的监测这些cpus上的lockups
> +事件。
> +
> +不论哪种情况都可以通过sysctl命令kernel.watchdog_cpumask来调节未运行
> +watchdog的cpu集合.对于nohz_full而言,如果nohz_full cpu上有异常挂住的情况,
> +通过这种方式打开这些cpu上的watchdog进行调试可能会有所作用。
> --
> 2.17.1
>
>

Thanks,

Yanteng