From a785b4349c9041c81e0fb17060e0c0c4ece99439 Mon Sep 17 00:00:00 2001 From: Karolin Seeger Date: Mon, 19 Jul 2010 11:54:05 +0200 Subject: s3-docs: Remove older documentation of smb2 parameters. Jeremy, these parameters were already documented. My fault. Sorry for the noise! Karolin --- docs-xml/smbdotconf/tuning/smb2maxread.xml | 13 ------------- docs-xml/smbdotconf/tuning/smb2maxtrans.xml | 13 ------------- docs-xml/smbdotconf/tuning/smb2maxwrite.xml | 13 ------------- 3 files changed, 39 deletions(-) delete mode 100644 docs-xml/smbdotconf/tuning/smb2maxread.xml delete mode 100644 docs-xml/smbdotconf/tuning/smb2maxtrans.xml delete mode 100644 docs-xml/smbdotconf/tuning/smb2maxwrite.xml (limited to 'docs-xml') diff --git a/docs-xml/smbdotconf/tuning/smb2maxread.xml b/docs-xml/smbdotconf/tuning/smb2maxread.xml deleted file mode 100644 index a3abbbc4ca..0000000000 --- a/docs-xml/smbdotconf/tuning/smb2maxread.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - This sets the maximum read size in bytes for a single SMB2 read request. - It exists to allow the Samba developers to experiment with different - size requests for tuning purposes. - - - -65536 - diff --git a/docs-xml/smbdotconf/tuning/smb2maxtrans.xml b/docs-xml/smbdotconf/tuning/smb2maxtrans.xml deleted file mode 100644 index 4e6fee0e75..0000000000 --- a/docs-xml/smbdotconf/tuning/smb2maxtrans.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - This sets the maximum read size in bytes for a single SMB2 transact request. - It exists to allow the Samba developers to experiment with different - size requests for tuning purposes. - - - -65536 - diff --git a/docs-xml/smbdotconf/tuning/smb2maxwrite.xml b/docs-xml/smbdotconf/tuning/smb2maxwrite.xml deleted file mode 100644 index 5085dba435..0000000000 --- a/docs-xml/smbdotconf/tuning/smb2maxwrite.xml +++ /dev/null @@ -1,13 +0,0 @@ - - - This sets the maximum read size in bytes for a single SMB2 write request. - It exists to allow the Samba developers to experiment with different - size requests for tuning purposes. - - - -65536 - -- cgit From 4c0f760edfa9ccdfe0340af46c27e388457ae9af Mon Sep 17 00:00:00 2001 From: Volker Lendecke Date: Mon, 19 Jul 2010 12:22:05 +0200 Subject: s3-docs: Add more verbose description of "username map cache time". --- .../smbdotconf/security/usernamemapcachetime.xml | 23 +++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) (limited to 'docs-xml') diff --git a/docs-xml/smbdotconf/security/usernamemapcachetime.xml b/docs-xml/smbdotconf/security/usernamemapcachetime.xml index 5461cb1a6c..4361b1896d 100644 --- a/docs-xml/smbdotconf/security/usernamemapcachetime.xml +++ b/docs-xml/smbdotconf/security/usernamemapcachetime.xml @@ -4,13 +4,22 @@ type="integer" xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> - This option controls if and how long the result of the - and - across smbds in gencache. - If set to non-zero, it denotes the number of seconds the output of - both mappings will be cached. - This option is mainly useful for heavy-weight - scripts. + + Mapping usernames with the + or + features of Samba can be relatively expensive. + During login of a user, the mapping is done several times. + In particular, calling the + can slow down logins if external databases have to be queried from + the script being called. + + + + The parameter + controls a mapping cache. It specifies the number of seconds a + mapping from the username map file or script is to be efficiently cached. + The default of 0 means no caching is done. + 0 -- cgit From 775f1ed045666f30e2b45512b30ed8e9a0df322a Mon Sep 17 00:00:00 2001 From: Volker Lendecke Date: Mon, 19 Jul 2010 12:35:58 +0200 Subject: s3-docs: Add more verbose description of "ctdb locktime warn threshold". --- .../smbdotconf/misc/ctdblocktimewarnthreshold.xml | 26 ++++++++++++++++------ 1 file changed, 19 insertions(+), 7 deletions(-) (limited to 'docs-xml') diff --git a/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml b/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml index 149d8d67e3..a3289a93bc 100644 --- a/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml +++ b/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml @@ -4,13 +4,25 @@ advanced="1" xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> - In a cluster, ctdb is very unhappy if tdb database locks - are held for extended periods of time. This parameter adds a - warning threshold in milliseconds. If Samba holds a lock for - longer that ctdb locktime warn threshold milliseconds, a debug - level 0 message is printed when the lock is released. This is - mainly a debugging aid for post-mortem analysis. - If this parameter is set to 0, no message is printed. + + + In a cluster environment using Samba and ctdb it is critical + that locks on central ctdb-hosted databases like locking.tdb + are not held for long. With the current Samba architecture + it happens that Samba takes a lock and while holding that + lock makes file system calls into the shared cluster file + system. This option makes Samba warn if it detects that it + has held locks for the specified number of milliseconds. If + this happens, smbd will emit a debug level 0 + message into its logs and potentially into syslog. The most likely + reason for such a log message is that an operation of the cluster + file system Samba exports is taking longer than expected. + The messages are meant as a debugging aid for potential + cluster problems. + + + The default value of 0 disables this logging. + 0 -- cgit From b742c4952e1df7a898a73330e9c01a8f48a557b4 Mon Sep 17 00:00:00 2001 From: Volker Lendecke Date: Mon, 19 Jul 2010 12:47:09 +0200 Subject: s3-docs: Add more verbose description of "log writeable files on exit". --- docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) (limited to 'docs-xml') diff --git a/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml b/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml index 1c75457803..9d2b750943 100644 --- a/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml +++ b/docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml @@ -5,10 +5,17 @@ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> - This boolean option controls whether at exit time the server - dumps a list of files with debug level 0 that were still open - for write. This is an administrative aid to find the files - that were potentially corrupt if the network connection died. + When the network connection between a CIFS client and Samba + dies, Samba has no option but to simply shut down the server + side of the network connection. If this happens, there is a + risk of data corruption because the Windows client did not + complete all write operations that the Windows application + requested. Setting this option to "yes" makes smbd log with + a level 0 message a list of all files that have been opened + for writing when the network connection died. Those are the + files that are potentially corrupted. It is meant as an aid + for the administrator to give him a list of files to do + consistency checks on. -- cgit