[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