docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="FAKEDIRECTORYCREATETIMES"/>fake directory create times (S)</term>
   3                 <listitem><para>NTFS and Windows VFAT file systems keep a create
   4                 time for all files and directories. This is not the same as the
   5                 ctime - status change time - that Unix keeps, so Samba by default
   6                 reports the earliest of the various times Unix does keep. Setting
   7                 this parameter for a share causes Samba to always report midnight
   8                 1-1-1980 as the create time for directories.</para>
   9
  10                 <para>This option is mainly used as a compatibility option for
  11                 Visual C++ when used against Samba shares. Visual C++ generated
  12                 makefiles have the object directory as a dependency for each object
  13                 file, and a make rule to create the directory. Also, when NMAKE
  14                 compares timestamps it uses the creation time when examining a
  15                 directory. Thus the object directory will be created if it does not
  16                 exist, but once it does exist it will always have an earlier
  17                 timestamp than the object files it contains.</para>
  18
  19                 <para>However, Unix time semantics mean that the create time
  20                 reported by Samba will be updated whenever a file is created or
  21                 or deleted in the directory.  NMAKE finds all object files in
  22                 the object directory.  The timestamp of the last one built is then
  23                 compared to the timestamp of the object directory.  If the
  24                 directory's timestamp if newer, then all object files
  25                 will be rebuilt.  Enabling this option
  26                 ensures directories always predate their contents and an NMAKE build
  27                 will proceed as expected.</para>
  28
  29                 <para>Default: <command moreinfo="none">fake directory create times = no</command></para>
  30                 </listitem>
  31                 </samba:parameter>