Author: jpeach
Date: 2006-04-20 03:15:20 +0000 (Thu, 20 Apr 2006)
New Revision: 937

WebSVN: 
http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=937

Log:
Document the "fam change notify" and "dmapi support" parameters.

Added:
   trunk/smbdotconf/misc/dmapisupport.xml
   trunk/smbdotconf/misc/famchangenotify.xml


Changeset:
Added: trunk/smbdotconf/misc/dmapisupport.xml
===================================================================
--- trunk/smbdotconf/misc/dmapisupport.xml      2006-04-17 22:35:57 UTC (rev 
936)
+++ trunk/smbdotconf/misc/dmapisupport.xml      2006-04-20 03:15:20 UTC (rev 
937)
@@ -0,0 +1,29 @@
+<samba:parameter name="dmapi support"
+                 context="S"
+                                type="boolean"
+                 advanced="1" developer="1"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc";>
+<description>
+       <para>This parameter specifies whether Samba should use DMAPI to
+       determine whether a file is offline or not. This would typically
+       be used in conjunction with a hierarchical storage system that
+       automatically migrates files to tape.
+       </para>
+
+       <para>Note that Samba infers the status of a file by examining the
+       events that a DMAPI application has registered interest in. This
+       heuristic is satisfactory for a number of hierarchical storage
+       systems, but there may be system for which it will fail. In this
+       case, Samba may erroneously report files to be offline.
+       </para>
+
+       <para>This parameter is only available if a supported DMAPI
+       implementation was found at compilation time. It will only be used
+       if DMAPI is found to enabled on the system at run time.
+       </para>
+
+       <para>
+       </para>
+</description>
+<value type="default">no</value>
+</samba:parameter>

Added: trunk/smbdotconf/misc/famchangenotify.xml
===================================================================
--- trunk/smbdotconf/misc/famchangenotify.xml   2006-04-17 22:35:57 UTC (rev 
936)
+++ trunk/smbdotconf/misc/famchangenotify.xml   2006-04-20 03:15:20 UTC (rev 
937)
@@ -0,0 +1,20 @@
+<samba:parameter name="fam change notify"
+                 context="G"
+                                type="boolean"
+                 advanced="1" developer="1"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc";>
+<description>
+       <para>This parameter specifies whether Samba should ask the 
+       FAM daemon change notifications in directories so that
+       SMB clients can refresh whenever the data on the server changes.
+       </para>
+
+       <para>This parameter is only used when your system supports 
+       change notification to user programs, using the FAM daemon. If the FAM
+       daemon is not running, this parameter is automatically disabled. The
+       <parameter moreinfo=none>kernel change notify</parameter>
+       parameter will take precedence if it is also enabled.
+       </para>
+</description>
+<value type="default">yes</value>
+</samba:parameter>

Reply via email to