Merge Samba3 and Samba4 together
[bbaumbach/samba-autobuild/.git] / docs-xml / smbdotconf / security / forcesecuritymode.xml
1 <samba:parameter name="force security mode"
2                  context="S"
3                                  type="string"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6     <para>
7         This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating 
8     the UNIX permission on a file using the native NT security dialog box.
9         </para>
10                 
11     <para>
12         This parameter is applied as a mask (OR'ed with) to the changed permission bits, thus forcing any bits in this
13         mask that the user may have modified to be on.  Make sure not to mix up this parameter with <smbconfoption
14         name="security mask"/>, which works similar like this one but uses logical AND instead of OR. 
15         </para>
16
17         <para>
18         Essentially, one bits in this mask may be treated as a set of bits that, when modifying security on a file,
19         the user has always set to be on.
20         </para>
21
22     <para>
23         If not set explicitly this parameter is set to 0, and allows a user to modify all the user/group/world
24         permissions on a file, with no restrictions.
25         </para>
26                 
27     <para><emphasis>
28         Note</emphasis> that users who can access the Samba server through other means can easily bypass this
29         restriction, so it is primarily useful for standalone &quot;appliance&quot; systems. Administrators of most
30         normal systems will probably want to leave this set to 0000.
31         </para>
32
33 </description>
34
35 <value type="default">0</value>
36 <value type="example">700</value>
37
38 <related>force directory security mode</related>
39 <related>directory security mask</related>
40 <related>security mask</related>
41 </samba:parameter>