Fix up the man pages to explain that "store dos attributes" overrides them.
authorJeremy Allison <jra@samba.org>
Mon, 6 May 2013 21:10:58 +0000 (14:10 -0700)
committerAndrew Bartlett <abartlet@samba.org>
Mon, 6 May 2013 23:24:53 +0000 (01:24 +0200)
Signed-off-by: Jeremy Allison <jra@samba.org>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
Autobuild-User(master): Andrew Bartlett <abartlet@samba.org>
Autobuild-Date(master): Tue May  7 01:24:54 CEST 2013 on sn-devel-104

docs-xml/smbdotconf/filename/maparchive.xml
docs-xml/smbdotconf/filename/maphidden.xml
docs-xml/smbdotconf/filename/mapreadonly.xml
docs-xml/smbdotconf/filename/mapsystem.xml
docs-xml/smbdotconf/filename/storedosattributes.xml

index ead72cf25a193ea0152b4747dea2271e71e235ff..33ff876c74bf502db87679dd3a8ab16b5ab79cf6 100644 (file)
        be quite annoying for shared source code, documents, etc...
        </para>
 
+       <para>
+       Note that this parameter will be ignored if the <smbconfoption name="store dos attributes"/>
+       parameter is set, as the DOS archive attribute will then be stored inside a UNIX extended
+       attribute.
+       </para>
+
        <para>
        Note that this requires the <smbconfoption name="create mask"/> parameter to be set such that owner 
        execute bit is not masked out (i.e. it must include 100). See the parameter 
index 841c6876e62372438750b60a7767a7b0ee4babf6..004f493ec9429f29bfecac845db39bd6b7d3a71a 100644 (file)
@@ -7,6 +7,12 @@
        This controls whether DOS style hidden files should be mapped to the UNIX world execute bit.
        </para>
 
+       <para>
+       Note that this parameter will be ignored if the <smbconfoption name="store dos attributes"/>
+       parameter is set, as the DOS hidden attribute will then be stored inside a UNIX extended
+       attribute.
+       </para>
+
        <para>
        Note that this requires the <smbconfoption name="create mask"/> to be set such that the world execute 
        bit is not masked out (i.e. it must include 001). See the parameter <smbconfoption name="create mask"/> 
index 24a2c841432850a3a869414eae4d6ab39d50389b..f4ac7c8014cbd470ed423f895f4f5483c2e2c1d5 100644 (file)
                </para></listitem>
     </itemizedlist>
 
+        <para>
+        Note that this parameter will be ignored if the <smbconfoption name="store dos attributes"/>
+        parameter is set, as the DOS 'read-only' attribute will then be stored inside a UNIX extended
+        attribute.
+        </para>
+
 </description>
 <value type="default">yes</value>
 </samba:parameter>
index 021602d57855c43090ff158e339442efcc818761..5605d8860a09c17a5d3cb1d37a47b212844797a5 100644 (file)
@@ -7,6 +7,12 @@
        This controls whether DOS style system files should be mapped to the UNIX group execute bit.
        </para>
 
+        <para>
+        Note that this parameter will be ignored if the <smbconfoption name="store dos attributes"/>
+        parameter is set, as the DOS system attribute will then be stored inside a UNIX extended
+        attribute.
+        </para>
+
        <para>
        Note that this requires the <smbconfoption name="create mask"/> to be set such that the group 
        execute bit is not masked out (i.e. it must include 010). See the parameter 
index 621b4ace742f1444c631a49ecb2e30b00b82623b..acd78b076ee6ab0dfedf7637c544c82998d9824e 100644 (file)
@@ -8,9 +8,9 @@
        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
        as occurs with <smbconfoption name="map hidden"/> and <smbconfoption name="map readonly"/>).  When set, DOS
        attributes will be stored onto an extended attribute in the UNIX filesystem, associated with the file or
-       directory.  For no other mapping to occur as a fall-back, the parameters <smbconfoption name="map hidden"/>,
+       directory.  When this parameter is set it will override the parameters <smbconfoption name="map hidden"/>,
        <smbconfoption name="map system"/>, <smbconfoption name="map archive"/> and <smbconfoption name="map
-       readonly"/> must be set to off.  This parameter writes the DOS attributes as a string into the extended
+       readonly"/> and they will behave as if they were set to off. This parameter writes the DOS attributes as a string into the extended
        attribute named "user.DOSATTRIB". This extended attribute is explicitly hidden from smbd clients requesting an
        EA list. On Linux the filesystem must have been mounted with the mount option user_xattr in order for
        extended attributes to work, also extended attributes must be compiled into the Linux kernel.