docs-xml/smbdotconf/tuning/strictrename.xml

   1 <samba:parameter name="strict rename"
   2                  context="S"
   3                  type="boolean"
   4                  function="_strict_rename"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7     <para>By default a Windows SMB server prevents directory
   8     renames when there are open file or directory handles below
   9     it in the filesystem hierarchy. Historically Samba has always
  10     allowed this as POSIX filesystem semantics require it.</para>
  11
  12     <para>This boolean parameter allows Samba to match the Windows
  13     behavior. Setting this to "yes" is a very expensive change,
  14     as it forces Samba to travers the entire open file handle
  15     database on every directory rename request. In a clustered
  16     Samba system the cost is even greater than the non-clustered
  17     case.</para>
  18
  19     <para>When set to "no" smbd only checks the local process
  20     the client is attached to for open files below a directory
  21     being renamed, instead of checking for open files across all
  22     smbd processes.</para>
  23
  24     <para>Because of the expense in fully searching the database,
  25     the default is "no", and it is recommended to be left that way
  26     unless a specific Windows application requires it to be changed.</para>
  27
  28     <para>If the client has requested UNIX extensions (POSIX
  29     pathnames) then renames are always allowed and this parameter
  30     has no effect.</para>
  31
  32     <para>Enabling <smbconfoption name="smb3 directory leases"/> implicitly
  33     enables <smbconfoption name="strict rename"/>.</para>
  34
  35 </description>
  36
  37 <value type="default">no</value>
  38 </samba:parameter>