1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-25 23:21:54 +03:00
samba-mirror/docs-xml/smbdotconf/security/inheritpermissions.xml
Michael Adam 64b720d284 docs:smbdotconf: make formatting of headers uniform.
Signed-off-by: Michael Adam <obnox@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
2015-07-31 01:55:29 +02:00

36 lines
1.4 KiB
XML

<samba:parameter name="inherit permissions"
context="S"
type="boolean"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>
The permissions on new files and directories are normally governed by <smbconfoption name="create mask"/>,
<smbconfoption name="directory mask"/>, <smbconfoption name="force create mode"/> and <smbconfoption
name="force directory mode"/> but the boolean inherit permissions parameter overrides this.
</para>
<para>New directories inherit the mode of the parent directory,
including bits such as setgid.</para>
<para>
New files inherit their read/write bits from the parent directory. Their execute bits continue to be
determined by <smbconfoption name="map archive"/>, <smbconfoption name="map hidden"/> and <smbconfoption
name="map system"/> as usual.
</para>
<para>Note that the setuid bit is <emphasis>never</emphasis> set via
inheritance (the code explicitly prohibits this).</para>
<para>This can be particularly useful on large systems with
many users, perhaps several thousand, to allow a single [homes]
share to be used flexibly by each user.</para>
</description>
<related>create mask</related>
<related>directory mask</related>
<related>force create mode</related>
<related>force directory mode</related>
<value type="default">no</value>
</samba:parameter>