s3-docs: Add more verbose description of "log writeable files on exit".
authorVolker Lendecke <vl@samba.org>
Mon, 19 Jul 2010 10:47:09 +0000 (12:47 +0200)
committerKarolin Seeger <kseeger@samba.org>
Mon, 19 Jul 2010 10:47:09 +0000 (12:47 +0200)
docs-xml/smbdotconf/misc/logwriteablefilesonexit.xml

index 1c7545780350a4fc482efd10841e3349181da82a..9d2b75094385727581748dac5b790619940a37eb 100644 (file)
@@ -5,10 +5,17 @@
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
        <para>
-       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.
        </para>
 </description>