← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/misc/fakedirectorycreatetimes.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

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