docs/docbook/smbdotconf/security/createmask.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="CREATEMASK"/>create mask (S)</term>
   3                 <listitem><para>A synonym for this parameter is
   4                 <link linkend="CREATEMODE"><parameter moreinfo="none">create mode</parameter>
   5                 </link>.</para>
   6
   7                 <para>When a file is created, the necessary permissions are
   8                 calculated according to the mapping from DOS modes to UNIX
   9                 permissions, and the resulting UNIX mode is then bit-wise 'AND'ed
  10                 with this parameter. This parameter may be thought of as a bit-wise
  11                 MASK for the UNIX modes of a file. Any bit <emphasis>not</emphasis>
  12                 set here will be removed from the modes set on a file when it is
  13                 created.</para>
  14
  15                 <para>The default value of this parameter removes the
  16                 'group' and 'other' write and execute bits from the UNIX modes.</para>
  17
  18                 <para>Following this Samba will bit-wise 'OR' the UNIX mode created
  19                 from this parameter with the value of the <link linkend="FORCECREATEMODE"><parameter moreinfo="none">force create mode</parameter></link>
  20                 parameter which is set to 000 by default.</para>
  21
  22                 <para>This parameter does not affect directory modes. See the
  23                 parameter <link linkend="DIRECTORYMODE"><parameter moreinfo="none">directory mode
  24                 </parameter></link> for details.</para>
  25
  26                 <para>See also the <link linkend="FORCECREATEMODE"><parameter moreinfo="none">force
  27                 create mode</parameter></link> parameter for forcing particular mode
  28                 bits to be set on created files. See also the <link linkend="DIRECTORYMODE">
  29                 <parameter moreinfo="none">directory mode</parameter></link> parameter for masking
  30                 mode bits on created directories.  See also the <link linkend="INHERITPERMISSIONS">
  31                 <parameter moreinfo="none">inherit permissions</parameter></link> parameter.</para>
  32
  33                 <para>Note that this parameter does not apply to permissions
  34                 set by Windows NT/2000 ACL editors. If the administrator wishes to enforce
  35                 a mask on access control lists also, they need to set the <link linkend="SECURITYMASK"><parameter moreinfo="none">security mask</parameter></link>.</para>
  36
  37                 <para>Default: <command moreinfo="none">create mask = 0744</command></para>
  38                 <para>Example: <command moreinfo="none">create mask = 0775</command></para></listitem>
  39                 </samba:parameter>