docs-xml/smbdotconf/tuning/strictrename.xml

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