22dc5eb3267c51c73c43c1ad7788e9dc392f6623
[gd/samba-autobuild/.git] / docs-xml / smbdotconf / security / createmask.xml
1 <samba:parameter name="create mask"
2                  context="S"
3                                  type="integer"
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 </description>
30
31 <related>force create mode</related>
32 <related>directory mode</related>
33 <related>inherit permissions</related>
34
35 <value type="default">0744</value>
36 <value type="example">0775</value>
37 </samba:parameter>