[Cluster-devel] [PATCH 03/10] dlm_tool man: add dynamic setting and examples

[Heming Zhao <heming.zhao@suse.com>]

Signed-off-by: Heming Zhao <heming.zhao@suse.com>
---
 dlm_tool/dlm_tool.8 | 57 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/dlm_tool/dlm_tool.8 b/dlm_tool/dlm_tool.8
index 086596c67dbf..cdfe948815bf 100644
--- a/dlm_tool/dlm_tool.8
+++ b/dlm_tool/dlm_tool.8
@@ -176,6 +176,8 @@ dlm_tool run|run_start [-n] \fIcommand\fP
 "lvm lvchange --refresh"
 .br
 "lvm lvs"
+.br
+"opt dlm_controld-config-item=x"  (see below \fBEXAMPLES\fP section)
 .RE
 
 -
@@ -194,6 +196,61 @@ dlm_tool -h
 
 dlm_tool -V
 
+.SH EXAMPLES
+
+command \fIdlm_tool run "opt xxx"\fP can do the dynamic config job. It makes possible to debug, or to do flexible operations on the fly.
+
+If the line of "dlm_tool dump_config" output leading with "(*)", the START symbol, it means this item supports dynamic config. i.e.
+
+.RS 4
+.EX
+# dlm_tool dump_config | grep log_debug
+(*-) log_debug=1
+.EE
+
+The "log_debug" supports dynamic setting.
+.br
+The '-' (minus) means dynamic config doesn't take effect on this item.
+.br
+If "(*-)" becomes "(*+)", it means this item is dynamically changed on the fly.
+.RE
+
+
+Below show options: restore, restore_all
+
+.RS 4
+.EX
+# dlm_tool dump_config | grep log_debug
+(*-) log_debug=1
+# dlm_tool run "opt log_debug=0"
+# dlm_tool dump_config | grep log_debug
+(*+) log_debug=0
+
+# dlm_tool run "opt log_debug=1"
+# dlm_tool dump_config | grep log_debug
+(*+) log_debug=1
+
+# dlm_tool run "opt log_debug=restore"
+# dlm_tool dump_config | grep log_debug
+(*-) log_debug=1
+
+# dlm_tool dump_config | grep _debug
+(*-) daemon_debug=0
+(*-) log_debug=1
+(*-) plock_debug=0
+# dlm_tool run "opt daemon_debug=1 log_debug=0"
+# dlm_tool dump_config | grep _debug
+(*+) daemon_debug=1
+(*+) log_debug=0
+(*-) plock_debug=0
+# dlm_tool run "opt restore_all"
+# dlm_tool dump_config | grep _debug
+(*-) daemon_debug=0
+(*-) log_debug=1
+(*-) plock_debug=0
+.EE
+.RE
+
 .SH SEE ALSO
 .BR dlm_controld (8),
 .BR dlm.conf (5)
-- 
2.32.0