summaryrefslogtreecommitdiff
path: root/docs-xml/smbdotconf/security/directorymask.xml
blob: 2ebfc16d14f1b01d7f3cab630d7fc8b8eafb44cb (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
<samba:parameter name="directory mask"
	context="S"
	type="string"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<synonym>directory mode</synonym>
<description>
    <para>This parameter is the octal modes which are 
    used when converting DOS modes to UNIX modes when creating UNIX 
    directories.</para>

    <para>When a directory 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 directory. Any bit <emphasis>not</emphasis> set 
    here will be removed from the modes set on a directory when it is 
    created.</para>

    <para>The default value of this parameter removes the 'group' 
    and 'other' write bits from the UNIX mode, allowing only the 
    user who owns the directory to modify it.</para>
		
    <para>Following this Samba will bit-wise 'OR' the UNIX mode 
    created from this parameter with the value of the <smbconfoption name="force directory mode"/> parameter. 
    This parameter is set to 000 by default (i.e. no extra mode bits are added).</para>

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

<related>force directory mode</related>
<related>create mask</related>
<related>inherit permissions</related>
<value type="default">0755</value>
<value type="example">0775</value>
</samba:parameter>