kernel/watchdog: Modify the explanation and doc related to watchdog thread
v2 cover kernel/watchdog: Modify the explanation and doc related to watchdog thread
"watchdog/%u" threads has be replaced by cpu_stop_work. The current description is extremely misleading, so we need to modify the explanation and documentation related to this.
Wang Qing (4):
kernel: watchdog: Modify the explanation related to watchdog thread
doc: watchdog: Delete the explanation about "watchdog/%u".
doc: watchdog: Modify the explanation related to watchdog thread
doc: watchdog: Modify the doc related to "watchdog/%u"
.../admin-guide/kernel-per-CPU-kthreads.rst | 20 -------------------- Documentation/admin-guide/lockup-watchdogs.rst | 4 ++-- Documentation/admin-guide/sysctl/kernel.rst | 10 +++++----- kernel/watchdog.c | 12 ++++-------- 4 files changed, 11 insertions(+), 35 deletions(-)
Signature · 1 line
2.7.4
PATCH v2 1/4 kernel: watchdog: Modify the explanation related to watchdog thread
The watchdog thread has been replaced by cpu_stop_work, modify the explanation related.
--- kernel/watchdog.c | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-)
kernel/watchdog.c +4 -8
@@ -92,7 +92,7 @@ __setup("nmi_watchdog=", hardlockup_panic_setup);* own hardlockup detector. * * watchdog_nmi_enable/disable can be implemented to start and stop when -* softlockup watchdog threads start and stop. The arch must select the +* softlockup watchdog start and stop. The arch must select the * SOFTLOCKUP_DETECTOR Kconfig. */ int __weak watchdog_nmi_enable (unsigned int cpu)
@@ -322,7 +322,7 @@ static DEFINE_PER_CPU(struct completion, softlockup_completion); static DEFINE_PER_CPU(struct cpu_stop_work, softlockup_stop_work);/* -* The watchdog thread function - touches the timestamp. +* The watchdog feed function - touches the timestamp. * * It only runs once every sample_period seconds (4 seconds by * default) to reset the softlockup timestamp. If this gets delayed
@@ -551,11 +551,7 @@ static void lockup_detector_reconfigure(void) }/* -* Create the watchdog thread infrastructure and configure the detector(s). -* -* The threads are not unparked as watchdog_allowed_mask is empty. When -* the threads are successfully initialized, take the proper locks and -* unpark the threads in the watchdog_cpumask if the watchdog is enabled. +* Create the watchdog infrastructure and configure the detector(s). */ static __init void lockup_detector_setup (void ) {
@@ -621,7 +617,7 @@ void lockup_detector_soft_poweroff(void)#ifdef CONFIG_SYSCTL -/* Propagate any changes to the watchdog threads */ +/* Propagate any changes to the watchdog infrastructure */ static void proc_watchdog_update (void ) {/* Remove impossible cpus to keep sysctl output clean. */
Signature · 1 line
2.7.4
PATCH v2 2/4 doc: watchdog: Delete the explanation about "watchdog/%u".
In reply to Wang Qing"watchdog/%u" threads has be replaced by cpu_stop_work. The current description is extremely misleading, so delete the explanation about "watchdog/%u".
--- .../admin-guide/kernel-per-CPU-kthreads.rst | 20 -------------------- 1 file changed, 20 deletions(-)
Documentation/admin-guide/kernel-per-CPU-kthreads.rst +0 -20
@@ -332,23 +332,3 @@ To reduce its OS jitter, do at least one of the following: kthreads from being created in the first place. However, please note that this will not eliminate OS jitter, but will instead shift it to RCU_SOFTIRQ. - -Name: - watchdog/%u - -Purpose: - Detect software lockups on each CPU. - -To reduce its OS jitter, do at least one of the following: - -1. Build with CONFIG_LOCKUP_DETECTOR=n, which will prevent these - kthreads from being created in the first place. -2. Boot with "nosoftlockup=0", which will also prevent these kthreads - from being created. Other related watchdog and softlockup boot - parameters may be found in Documentation/admin-guide/kernel-parameters.rst - and Documentation/watchdog/watchdog-parameters.rst. -3. Echo a zero to /proc/sys/kernel/watchdog to disable the - watchdog timer. -4. Echo a large number of /proc/sys/kernel/watchdog_thresh in - order to reduce the frequency of OS jitter due to the watchdog - timer down to a level that is acceptable for your workload.
Signature · 1 line
2.7.4
PATCH v2 3/4 doc: watchdog: Modify the explanation related to watchdog thread
In reply to Wang Qing"watchdog/%u" threads has be replaced by cpu_stop_work. The current description is extremely misleading.
--- Documentation/admin-guide/lockup-watchdogs.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
Documentation/admin-guide/lockup-watchdogs.rst +2 -2
@@ -39,7 +39,7 @@ in principle, they should work in any architecture where these subsystems are present. A periodic hrtimer runs to generate interrupts and kick the watchdog -task. An NMI perf event is generated every "watchdog_thresh" +job. An NMI perf event is generated every "watchdog_thresh" (compile-time initialized to 10 and configurable through sysctl of the same name) seconds to check for hardlockups. If any CPU in the system does not receive any hrtimer interrupt during that time the
@@ -47,7 +47,7 @@ does not receive any hrtimer interrupt during that time the generate a kernel warning or call panic, depending on the configuration. -The watchdog task is a high priority kernel thread that updates a +The watchdog job runs in a stop scheduling thread that updates a timestamp every time it is scheduled. If that timestamp is not updated for 2*watchdog_thresh seconds (the softlockup threshold) the 'softlockup detector' (coded inside the hrtimer callback function)
Signature · 1 line
2.7.4
PATCH v2 4/4 doc: watchdog: Modify the doc related to "watchdog/%u"
In reply to Wang Qing"watchdog/%u" threads has be replaced by cpu_stop_work. The current description is extremely misleading.
--- Documentation/admin-guide/sysctl/kernel.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-)
Documentation/admin-guide/sysctl/kernel.rst +5 -5
@@ -1282,11 +1282,11 @@ This parameter can be used to control the soft lockup detector. = ================================= The soft lockup detector monitors CPUs for threads that are hogging the CPUs -without rescheduling voluntarily, and thus prevent the 'watchdog/N' threads -from running. The mechanism depends on the CPUs ability to respond to timer -interrupts which are needed for the 'watchdog/N' threads to be woken up by -the watchdog timer function, otherwise the NMI watchdog — if enabled — can -detect a hard lockup condition. +without rescheduling voluntarily, and thus prevent the 'migration/N' threads +from running, causing the watchdog work fail to execute. The mechanism depends +on the CPUs ability to respond to timer interrupts which are needed for the +watchdog work to be queued by the watchdog timer function, otherwise the NMI +watchdog — if enabled — can detect a hard lockup condition. stack_erasing
Signature · 1 line
2.7.4
Quoted 9 lines · Wang Qing
"watchdog/%u" threads has be replaced by
cpu_stop_work. The current description is extremely misleading, so we need to modify the explanation and documentation related to this.Wang Qing (4):
kernel: watchdog: Modify the explanation related to watchdog thread
doc: watchdog: Delete the explanation about "watchdog/%u".
doc: watchdog: Modify the explanation related to watchdog thread
doc: watchdog: Modify the doc related to "watchdog/%u"
All four patches make sense to me:
Best Regards,
Petr