← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/security/securitymask.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/smbdotconf/security/securitymask.xml
 
1
<samba:parameter name="security mask"
 
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 will be set when a Windows NT client is manipulating the
 
8
        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 (AND'ed with) to the incoming permission bits, thus resetting
 
13
        any bits not in this mask. Make sure not to mix up this parameter with <smbconfoption name="force
 
14
        security mode"/>, which works in a manner similar to this one but uses a logical OR instead of an AND. 
 
15
        </para>
 
16
 
 
17
    <para>
 
18
        Essentially, all bits set to zero in this mask will result in setting to zero the corresponding bits on the
 
19
        file permissions regardless of the previous status of this bits on the file.
 
20
    </para>
 
21
 
 
22
    <para>
 
23
        If not set explicitly this parameter is 0777, allowing a user to set all the user/group/world permissions on a file.
 
24
    </para>
 
25
 
 
26
    <para><emphasis>
 
27
        Note</emphasis> that users who can access the Samba server through other means can easily bypass this 
 
28
    restriction, so it is primarily useful for standalone &quot;appliance&quot; systems.  Administrators of
 
29
        most normal systems will probably want to leave it set to <constant>0777</constant>.
 
30
        </para>
 
31
</description>
 
32
 
 
33
<related>force directory security mode</related>
 
34
<related>directory security mask</related>
 
35
<related>force security mode</related>
 
36
 
 
37
<value type="default">0777</value>
 
38
<value type="example">0770</value>
 
39
</samba:parameter>