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>