File bug-1191734_0008-man-add-reload_config-in-dlm_tool-dlm.conf.patch of Package libdlm

From 6f764cceeb7350d8da33765da07462578f07e988 Mon Sep 17 00:00:00 2001
From: Heming Zhao <heming.zhao@suse.com>
Date: Fri, 8 Oct 2021 09:33:36 +0800
Subject: [PATCH 08/14] man: add reload_config in dlm_tool & dlm.conf

reload_config is a new command of dlm_tool. We could use this command
to change dlm_controld some settings on the fly.

This patch modifies man page to add usage for this new command.

Signed-off-by: Heming Zhao <heming.zhao@suse.com>
---
 dlm_controld/dlm.conf.5 | 42 ++++++++++++++++++++++++++++++-----------
 dlm_tool/dlm_tool.8     | 10 ++++++++++
 2 files changed, 41 insertions(+), 11 deletions(-)

diff --git a/dlm_controld/dlm.conf.5 b/dlm_controld/dlm.conf.5
index 1ce0c6445ee1..99e302a92bd2 100644
--- a/dlm_controld/dlm.conf.5
+++ b/dlm_controld/dlm.conf.5
@@ -34,7 +34,9 @@ protocol=tcp
 
 Options:
 
-log_debug
+daemon_debug(*)
+.br
+log_debug(*)
 .br
 protocol
 .br
@@ -42,23 +44,23 @@ bind_all
 .br
 mark
 .br
-debug_logfile
+debug_logfile(*)
 .br
 enable_plock
 .br
-plock_debug
+plock_debug(*)
 .br
-plock_rate_limit
+plock_rate_limit(*)
 .br
 plock_ownership
 .br
-drop_resources_time
+drop_resources_time(*)
 .br
-drop_resources_count
+drop_resources_count(*)
 .br
-drop_resources_age
+drop_resources_age(*)
 .br
-post_join_delay
+post_join_delay(*)
 .br
 enable_fencing
 .br
@@ -66,15 +68,33 @@ enable_concurrent_fencing
 .br
 enable_startup_fencing
 .br
-enable_quorum_fencing
+enable_quorum_fencing(*)
 .br
-enable_quorum_lockspace
+enable_quorum_lockspace(*)
 .br
-repeat_failed_fencing
+repeat_failed_fencing(*)
 .br
 enable_helper
 .br
 
+Option with tail (*) means this item can be reload on the fly by "dlm_tool reload_config". See \fB"Reload config"\fP for more examples.
+
+.SH Reload config
+
+dlm.conf can be changed then reloaded some settings on the fly, it gives users more flexible and powerful ability to manage dlm.
+
+The supported reload operations:
+.br
+- add a new item
+.br
+- remove an exist item
+.br
+- commented out an item
+.br
+- change an item value
+
+After modifying settings in dlm.conf, run "dlm_tool reload_config" to take effect. User can use "dlm_tool dump_config" to check the result. Again, only reloadable item can be changed.
+
 .SH Fencing
 
 A fence device definition begins with a
diff --git a/dlm_tool/dlm_tool.8 b/dlm_tool/dlm_tool.8
index 7e82f8908ed6..6c1d471abe68 100644
--- a/dlm_tool/dlm_tool.8
+++ b/dlm_tool/dlm_tool.8
@@ -28,6 +28,10 @@ dlm_tool \- a utility for the dlm and dlm_controld daemon
 .br
 	Dump dlm_controld config settings.
 
+.B reload_config
+.br
+	Reload dlm_controld config settings from dlm.conf.
+
 .BI fence_ack " nodeid"
 .br
 	Quit trying to fence a node.
@@ -134,6 +138,12 @@ Print program version information, then exit
 
 -
 
+.B dlm_tool reload_config
+
+* see examples in \fBdlm.conf(5)\fP
+
+-
+
 .B dlm_tool fence_ack \fInodeid\fP
 
 * run "dlm_tool status -v" to get \fInodeid\fP
-- 
2.33.0

openSUSE Build Service is sponsored by