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 <mar...@meltin.net> Date: Tue Feb 18 18:32:21 2020 +1100 ctdb-docs: Improve recovery lock documentation Signed-off-by: Martin Schwenke <mar...@meltin.net> Reviewed-by: Christof Schmitt <c...@samba.org> Autobuild-User(master): Martin Schwenke <mart...@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