summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/misc/fakedirectorycreatetimes.xml
blob: 81773606ee02a49948e5cb4f71cd85a8d4b07db5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="FAKEDIRECTORYCREATETIMES"/>fake directory create times (S)</term>
		<listitem><para>NTFS and Windows VFAT file systems keep a create 
		time for all files and directories. This is not the same as the 
		ctime - status change time - that Unix keeps, so Samba by default 
		reports the earliest of the various times Unix does keep. Setting 
		this parameter for a share causes Samba to always report midnight 
		1-1-1980 as the create time for directories.</para>

		<para>This option is mainly used as a compatibility option for 
		Visual C++ when used against Samba shares. Visual C++ generated 
		makefiles have the object directory as a dependency for each object 
		file, and a make rule to create the directory. Also, when NMAKE 
		compares timestamps it uses the creation time when examining a 
		directory. Thus the object directory will be created if it does not 
		exist, but once it does exist it will always have an earlier 
		timestamp than the object files it contains.</para>

		<para>However, Unix time semantics mean that the create time 
		reported by Samba will be updated whenever a file is created or 
		or deleted in the directory.  NMAKE finds all object files in 
		the object directory.  The timestamp of the last one built is then 
		compared to the timestamp of the object directory.  If the 
		directory's timestamp if newer, then all object files
		will be rebuilt.  Enabling this option 
		ensures directories always predate their contents and an NMAKE build 
		will proceed as expected.</para>

		<para>Default: <command moreinfo="none">fake directory create times = no</command></para>
		</listitem>
		</samba:parameter>