summaryrefslogtreecommitdiff
path: root/docs-xml/smbdotconf/security/createmask.xml
blob: 59e208dccd6446646b967a3ece667d5dee1b291f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
<samba:parameter name="create mask"
                 context="S"
				 type="string"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">

<synonym>create mode</synonym>
<description>
    <para>
	When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
	UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
	be thought of as a bit-wise MASK for the UNIX modes of a file. Any bit <emphasis>not</emphasis> set here will
	be removed from the modes set on a file when it is created.
	</para>

    <para>
	The default value of this parameter removes the <literal>group</literal> and <literal>other</literal>
	write and execute bits from the UNIX modes.
	</para>

    <para>
	Following this Samba will bit-wise 'OR' the UNIX mode created from this parameter with the value of the
	<smbconfoption name="force create mode"/> parameter which is set to 000 by default.
	</para>

    <para>
	This parameter does not affect directory masks. See the parameter <smbconfoption name="directory mask"/>
	for details.
	</para>

    <para>
	New in Samba 4.0.0. This mask is applied whenever permissions are changed on a file. To allow clients full control
	over permission changes it should be set to 0777.
	</para>
</description>

<related>force create mode</related>
<related>directory mode</related>
<related>inherit permissions</related>

<value type="default">0744</value>
<value type="example">0775</value>
</samba:parameter>