docs-xml/smbdotconf/vfs/vfsmkdirusetmpname.xml

   1 <samba:parameter name="vfs mkdir use tmp name"
   2                  context="S"
   3                  type="enum"
   4                  enumlist="enum_bool_auto"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7         <para>
   8         Creating a new directory for an SMB client is a very complex task!
   9         It includes things like inheriting permissions from the parent directory
  10         and storing DOS attributes.
  11         </para>
  12
  13         <para>
  14         Other clients should not see the existence of the directory that
  15         is in progress of being created!
  16         </para>
  17
  18         <para>
  19         This option is an enumerated type that controls the usage of a temporary directory name.
  20         When this is set to <constant>yes</constant>,
  21         the directory name will be prefixed with '.::TMPNAME:D:$SERVERID:' (where $SERVERID is
  22         a unique identifier for the current process).
  23         </para>
  24
  25         <para>
  26         When this option is set to Auto (the default), the server uses a temporary directory name
  27         if, at least, one of the following options
  28         is effectively not set to <constant>no</constant>:
  29         <smbconfoption name="inherit acls"/>,
  30         <smbconfoption name="inherit owner"/>,
  31         <smbconfoption name="inherit permissions"/>,
  32         <smbconfoption name="nt acl support"/> or
  33         <smbconfoption name="store dos attributes"/>.
  34         </para>
  35
  36         <para>
  37         A re-export of an SMB/CIFS mount might one rare case where
  38         <command moreinfo="none">vfs mkdir use tmp name = no</command> could be useful.
  39         </para>
  40
  41         <para>
  42         In most cases <command moreinfo="none">vfs mkdir use tmp name = Auto</command> should be kept.
  43         </para>
  44 </description>
  45 <value type="default">Auto</value>
  46 </samba:parameter>
  47