docs-xml/smbdotconf/security/createmask.xml

   1 <samba:parameter name="create mask"
   2                  context="S"
   3                                  type="string"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5
   6 <synonym>create mode</synonym>
   7 <description>
   8     <para>
   9         When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
  10         UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
  11         be thought of as a bit-wise MASK for the UNIX modes of a file. Any bit <emphasis>not</emphasis> set here will
  12         be removed from the modes set on a file when it is created.
  13         </para>
  14
  15     <para>
  16         The default value of this parameter removes the <literal>group</literal> and <literal>other</literal>
  17         write and execute bits from the UNIX modes.
  18         </para>
  19
  20     <para>
  21         Following this Samba will bit-wise 'OR' the UNIX mode created from this parameter with the value of the
  22         <smbconfoption name="force create mode"/> parameter which is set to 000 by default.
  23         </para>
  24
  25     <para>
  26         This parameter does not affect directory masks. See the parameter <smbconfoption name="directory mask"/>
  27         for details.
  28         </para>
  29
  30     <para>
  31         New in Samba 4.0.0. This mask is applied whenever permissions are changed on a file. To allow clients full control
  32         over permission changes it should be set to 0777.
  33         </para>
  34 </description>
  35
  36 <related>force create mode</related>
  37 <related>directory mode</related>
  38 <related>inherit permissions</related>
  39
  40 <value type="default">0744</value>
  41 <value type="example">0775</value>
  42 </samba:parameter>