docs/smbdotconf/filename/mapreadonly.xml

   1 <samba:parameter name="map read only"
   2                  context="S"
   3                  type="enum"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>
   7         This controls how the DOS read only attribute should be mapped from a UNIX filesystem.
   8         </para>
   9
  10         <para>
  11         This parameter can take three different values, which tell <citerefentry><refentrytitle>smbd</refentrytitle>
  12         <manvolnum>8</manvolnum></citerefentry> how to display the read only attribute on files, where either
  13         <smbconfoption name="store dos attributes"/> is set to <constant>No</constant>, or no extended attribute is
  14         present. If <smbconfoption name="store dos attributes"/> is set to <constant>yes</constant> then this
  15         parameter is <emphasis>ignored</emphasis>. This is a new parameter introduced in Samba version 3.0.21.
  16         </para>
  17
  18     <para>The three settings are :</para>
  19
  20     <itemizedlist>
  21                 <listitem><para>
  22                 <constant>Yes</constant> - The read only DOS attribute is mapped to the inverse of the user
  23                 or owner write bit in the unix permission mode set. If the owner write bit is not set, the
  24                 read only attribute is reported as being set on the file.
  25                 </para></listitem>
  26
  27                 <listitem><para>
  28                 <constant>Permissions</constant> - The read only DOS attribute is mapped to the effective permissions of
  29                 the connecting user, as evaluated by <citerefentry><refentrytitle>smbd</refentrytitle>
  30                 <manvolnum>8</manvolnum></citerefentry> by reading the unix permissions and POSIX ACL (if present).
  31                 If the connecting user does not have permission to modify the file, the read only attribute
  32                 is reported as being set on the file.
  33                 </para></listitem>
  34
  35                 <listitem><para>
  36                 <constant>No</constant> - The read only DOS attribute is unaffected by permissions, and can only be set by
  37                 the <smbconfoption name="store dos attributes"/> method. This may be useful for exporting mounted CDs.
  38                 </para></listitem>
  39     </itemizedlist>
  40
  41 </description>
  42 <value type="default">yes</value>
  43 </samba:parameter>