← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/security/inheritpermissions.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/inheritpermissions.xml
 
1
<samba:parameter name="inherit permissions"
 
2
                 context="S"
 
3
                                 type="boolean"
 
4
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
5
<description>
 
6
    <para>
 
7
        The permissions on new files and directories are normally governed by <smbconfoption name="create mask"/>,
 
8
        <smbconfoption name="directory mask"/>, <smbconfoption name="force create mode"/> and <smbconfoption
 
9
        name="force directory mode"/> but the boolean inherit permissions parameter overrides this.
 
10
        </para>
 
11
                
 
12
    <para>New directories inherit the mode of the parent directory,
 
13
    including bits such as setgid.</para>
 
14
 
 
15
    <para>
 
16
        New files inherit their read/write bits from the parent directory.  Their execute bits continue to be
 
17
        determined by <smbconfoption name="map archive"/>, <smbconfoption name="map hidden"/> and <smbconfoption
 
18
        name="map system"/> as usual.
 
19
        </para>
 
20
 
 
21
    <para>Note that the setuid bit is <emphasis>never</emphasis> set via 
 
22
    inheritance (the code explicitly prohibits this).</para>
 
23
 
 
24
    <para>This can be particularly useful on large systems with 
 
25
    many users, perhaps several thousand, to allow a single [homes] 
 
26
    share to be used flexibly by each user.</para>
 
27
</description>
 
28
 
 
29
<related>create mask</related>
 
30
<related>directory mask</related>
 
31
<related>force create mode</related>
 
32
<related>force directory mode</related>
 
33
 
 
34
<value type="default">no</value>
 
35
</samba:parameter>