krb5 commit: Document unlockiter
Tom Yu
tlyu at MIT.EDU
Sat Aug 2 14:24:31 EDT 2014
https://github.com/krb5/krb5/commit/20de23910012dcda1fd06d6ac7153adf2c0589b8
commit 20de23910012dcda1fd06d6ac7153adf2c0589b8
Author: Tom Yu <tlyu at mit.edu>
Date: Sat Aug 2 14:20:35 2014 -0400
Document unlockiter
ticket: 7977
doc/admin/admin_commands/kadmin_local.rst | 13 +++++++++++++
doc/admin/conf_files/kdc_conf.rst | 7 +++++++
2 files changed, 20 insertions(+), 0 deletions(-)
diff --git a/doc/admin/admin_commands/kadmin_local.rst b/doc/admin/admin_commands/kadmin_local.rst
index 8409303..faf7105 100644
--- a/doc/admin/admin_commands/kadmin_local.rst
+++ b/doc/admin/admin_commands/kadmin_local.rst
@@ -154,6 +154,19 @@ Supported options for the DB2 module are:
**-x dbname=**\ \*filename*
Specifies the base filename of the DB2 database.
+ **-x lockiter**
+ Make iteration operations hold the lock for the duration of
+ the entire operation, rather than temporarily releasing the
+ lock while handling each principal. This is the default
+ behavior, but this option exists to allow command line
+ override of a [dbmodules] setting. First introduced in
+ release 1.13.
+
+ **-x unlockiter**
+ Make iteration operations unlock the database for each
+ principal, instead of holding the lock for the duration of the
+ entire operation. First introduced in release 1.13.
+
Supported options for the LDAP module are:
**-x host=**\ *ldapuri*
diff --git a/doc/admin/conf_files/kdc_conf.rst b/doc/admin/conf_files/kdc_conf.rst
index eaeabda..d6bfd0e 100644
--- a/doc/admin/conf_files/kdc_conf.rst
+++ b/doc/admin/conf_files/kdc_conf.rst
@@ -456,6 +456,13 @@ The following tags may be specified in a [dbmodules] subsection:
**ldap_kdc_sasl_authcid** or **ldap_kadmind_sasl_authcid** names
for SASL authentication. This file must be kept secure.
+**unlockiter**
+ If set to ``true``, this DB2-specific tag causes iteration
+ operations to release the database lock while processing each
+ principal. Setting this flag to ``true`` can prevent extended
+ blocking of KDC or kadmin operations when dumps of large databases
+ are in progress. First introduced in release 1.13.
+
The following tag may be specified directly in the [dbmodules]
section to control where database modules are loaded from:
More information about the cvs-krb5
mailing list