[SCM] Samba Shared Repository - branch master updated
Martin Schwenke
martins at samba.org
Mon Mar 9 02:28:02 UTC 2020
The branch, master has been updated
via be90ab01bb4 ctdb-docs: Improve recovery lock documentation
from bb22be08b07 s3: tests: Add samba3.blackbox.force-close-share
https://git.samba.org/?p=samba.git;a=shortlog;h=master
- Log -----------------------------------------------------------------
commit be90ab01bb46ed38ab6c2dd737c66a9537c04327
Author: Martin Schwenke <martin at meltin.net>
Date: Tue Feb 18 18:32:21 2020 +1100
ctdb-docs: Improve recovery lock documentation
Signed-off-by: Martin Schwenke <martin at meltin.net>
Reviewed-by: Christof Schmitt <cs at samba.org>
Autobuild-User(master): Martin Schwenke <martins at samba.org>
Autobuild-Date(master): Mon Mar 9 02:27:18 UTC 2020 on sn-devel-184
-----------------------------------------------------------------------
Summary of changes:
ctdb/doc/ctdb.7.xml | 33 +++++++++++++++++++++++++++------
1 file changed, 27 insertions(+), 6 deletions(-)
Changeset truncated at 500 lines:
diff --git a/ctdb/doc/ctdb.7.xml b/ctdb/doc/ctdb.7.xml
index 09fb4ed7d8f..2079ed713e3 100644
--- a/ctdb/doc/ctdb.7.xml
+++ b/ctdb/doc/ctdb.7.xml
@@ -112,12 +112,33 @@
<para>
The recovery lock can also be implemented using an arbitrary
- cluster mutex call-out by using an exclamation point ('!') as
- the first character of <parameter>recovery lock</parameter>.
- For example, a value of <command>!/usr/local/bin/myhelper
- recovery</command> would run the given helper with the specified
- arguments. See the source code relating to cluster mutexes for
- clues about writing call-outs.
+ cluster mutex helper (or call-out). This is indicated by using
+ an exclamation point ('!') as the first character of the
+ <parameter>recovery lock</parameter> parameter. For example, a
+ value of <command>!/usr/local/bin/myhelper recovery</command>
+ would run the given helper with the specified arguments. The
+ helper will continue to run as long as it holds its mutex. See
+ <filename>ctdb/doc/cluster_mutex_helper.txt</filename> in the
+ source tree, and related code, for clues about writing helpers.
+ </para>
+
+ <para>
+ When a file is specified for the <parameter>recovery
+ lock</parameter> parameter (i.e. no leading '!') the file lock
+ is implemented by a default helper
+ (<command>/usr/local/libexec/ctdb/ctdb_mutex_fcntl_helper</command>).
+ This helper has arguments as follows:
+
+ <!-- cmdsynopsis would not require long line but does not work :-( -->
+ <synopsis>
+<command>ctdb_mutex_fcntl_helper</command> <parameter>FILE</parameter> <optional><parameter>RECHECK-INTERVAL</parameter></optional>
+ </synopsis>
+
+ <command>ctdb_mutex_fcntl_helper</command> will take a lock on
+ FILE and then check every RECHECK-INTERVAL seconds to ensure
+ that FILE still exists and that its inode number is unchanged
+ from when the lock was taken. The default value for
+ RECHECK-INTERVAL is 5.
</para>
<para>
--
Samba Shared Repository
More information about the samba-cvs
mailing list