doc: "prune stale" and "sequence timeout" fssd parameters
authorDavid Disseldorp <ddiss@samba.org>
Wed, 26 Nov 2014 12:01:00 +0000 (13:01 +0100)
committerJeremy Allison <jra@samba.org>
Tue, 31 Mar 2015 16:40:25 +0000 (18:40 +0200)
This change adds smb.conf documentation for the "fss: prune stale" and
"fss: sequence timeout" parameters accepted by Samba's FSRVP server.

Signed-off-by: David Disseldorp <ddiss@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
docs-xml/smbdotconf/misc/fssprunestale.xml [new file with mode: 0644]
docs-xml/smbdotconf/misc/fsssequencetimeout.xml [new file with mode: 0644]
docs-xml/smbdotconf/misc/rpcdaemon.xml
python/samba/tests/docs.py

diff --git a/docs-xml/smbdotconf/misc/fssprunestale.xml b/docs-xml/smbdotconf/misc/fssprunestale.xml
new file mode 100644 (file)
index 0000000..d583104
--- /dev/null
@@ -0,0 +1,16 @@
+<samba:parameter name="fss: prune stale"
+                 context="G"
+                type="boolean"
+                advanced="1"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+       <para>
+       When enabled, Samba's File Server Remove VSS Protocol (FSRVP) server
+       checks all FSRVP initiated snapshots on startup, and removes any
+       corresponding state (including share definitions) for nonexistent
+       snapshot paths.
+       </para>
+</description>
+<value type="default">no</value>
+<value type="example">yes</value>
+</samba:parameter>
diff --git a/docs-xml/smbdotconf/misc/fsssequencetimeout.xml b/docs-xml/smbdotconf/misc/fsssequencetimeout.xml
new file mode 100644 (file)
index 0000000..9419a33
--- /dev/null
@@ -0,0 +1,16 @@
+<samba:parameter name="fss: sequence timeout"
+                 context="G"
+                type="integer"
+                advanced="1"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+       <para>
+       The File Server Remove VSS Protocol (FSRVP) server includes a message
+       sequence timer to ensure cleanup on unexpected client disconnect. This
+       parameter overrides the default timeout between FSRVP operations.
+       FSRVP timeouts can be completely disabled via a value of 0.
+       </para>
+</description>
+<value type="default">180 or 1800, depending on operation</value>
+<value type="example">0</value>
+</samba:parameter>
index 5fbe88625b8bb8e86327b96f34be6971a9bd5bf9..a06e91d613e9b0b74e561e99c1d0f457447a8905 100644 (file)
        </para>
 
        <para>
-       Samba includes separate daemons for spoolss and the lsarpc/lsass,
-       netlogon and samr pipes. Currently three daemons are available and they
-       are called:
+       Samba includes separate daemons for spoolss, lsarpc/lsass, netlogon,
+       samr, and FSRVP. Currently four daemons are available and they are
+       called:
        <programlisting>
                epmd
                lsasd
                spoolssd
+               fssd
        </programlisting>
        Example:
        <programlisting>
index d57701d47d0bdf5af3161f25f0e578f61bc2ef2a..3e7dcbc8e2fe0a68b6caff16377606923c9cf433 100644 (file)
@@ -131,7 +131,7 @@ class SmbDotConfTests(TestCase):
                          'queuepause command','lpresume command', 'lppause command',
                          'lprm command', 'lpq command', 'print command', 'template homedir',
                          'spoolss: os_major', 'spoolss: os_minor', 'spoolss: os_build',
-                         'max open files'])
+                         'max open files', 'fss: prune stale', 'fss: sequence timeout'])
 
     def setUp(self):
         super(SmbDotConfTests, self).setUp()