From e4629442a402cbea7d7a9ea6073f7b41ab3edd63 Mon Sep 17 00:00:00 2001
From: Karsten Blees <blees@dcon.de>
Date: Sun, 8 Sep 2013 14:23:27 +0200
Subject: [PATCH] add infrastructure for read-only file system level caches

Add a macro to mark code sections that only read from the file system,
along with a config option and documentation.

This facilitates implementation of relatively simple file system level
caches without the need to synchronize with the file system.

Enable read-only sections for 'git status' and preload_index.

Signed-off-by: Karsten Blees <blees@dcon.de>
---
 Documentation/config.txt |  6 ++++++
 builtin/commit.c         |  1 +
 cache.h                  |  2 ++
 config.c                 |  5 +++++
 environment.c            |  1 +
 git-compat-util.h        | 15 +++++++++++++++
 preload-index.c          |  2 ++
 7 files changed, 32 insertions(+)

diff --git a/Documentation/config.txt b/Documentation/config.txt
index 28d57e3381..81b966e1c4 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -623,6 +623,12 @@ relatively high IO latencies.  With this set to 'true', Git will do the
 index comparison to the filesystem data in parallel, allowing
 overlapping IO's.
 
+core.fscache::
+	Enable additional caching of file system data for some operations.
++
+Git for Windows uses this to bulk-read and cache lstat data of entire
+directories (instead of doing lstat file by file).
+
 core.createObject::
 	You can set this to 'link', in which case a hardlink followed by
 	a delete of the source are used to make sure that object creation
diff --git a/builtin/commit.c b/builtin/commit.c
index 9cfef6c6cc..3b0d7fd73b 100644
--- a/builtin/commit.c
+++ b/builtin/commit.c
@@ -1296,6 +1296,7 @@ int cmd_status(int argc, const char **argv, const char *prefix)
 		       PATHSPEC_PREFER_FULL,
 		       prefix, argv);
 
+	enable_fscache(1);
 	read_cache_preload(&s.pathspec);
 	refresh_index(&the_index, REFRESH_QUIET|REFRESH_UNMERGED, &s.pathspec, NULL, NULL);
 
diff --git a/cache.h b/cache.h
index 96d231aee4..57844a379a 100644
--- a/cache.h
+++ b/cache.h
@@ -610,6 +610,8 @@ enum hide_dotfiles_type {
 };
 extern enum hide_dotfiles_type hide_dotfiles;
 
+extern int core_fscache;
+
 enum branch_track {
 	BRANCH_TRACK_UNSPECIFIED = -1,
 	BRANCH_TRACK_NEVER = 0,
diff --git a/config.c b/config.c
index e28f17c6bb..75275988da 100644
--- a/config.c
+++ b/config.c
@@ -883,6 +883,11 @@ static int git_default_core_config(const char *var, const char *value)
 		return 0;
 	}
 
+	if (!strcmp(var, "core.fscache")) {
+		core_fscache = git_config_bool(var, value);
+		return 0;
+	}
+
 	/* Add other config variables here and to Documentation/config.txt. */
 	return 0;
 }
diff --git a/environment.c b/environment.c
index 6366c85241..2001bde19f 100644
--- a/environment.c
+++ b/environment.c
@@ -64,6 +64,7 @@ int precomposed_unicode = -1; /* see probe_utf8_pathname_composition() */
 struct startup_info *startup_info;
 unsigned long pack_size_limit_cfg;
 enum hide_dotfiles_type hide_dotfiles = HIDE_DOTFILES_DOTGITONLY;
+int core_fscache;
 
 /*
  * The character that begins a commented line in user-editable file
diff --git a/git-compat-util.h b/git-compat-util.h
index b7e145de62..f56261fec6 100644
--- a/git-compat-util.h
+++ b/git-compat-util.h
@@ -731,4 +731,19 @@ struct tm *git_gmtime_r(const time_t *, struct tm *);
 #define get_home_directory() getenv("HOME")
 #endif
 
+/*
+ * Enable/disable a read-only cache for file system data on platforms that
+ * support it.
+ *
+ * Implementing a live-cache is complicated and requires special platform
+ * support (inotify, ReadDirectoryChangesW...). enable_fscache shall be used
+ * to mark sections of git code that extensively read from the file system
+ * without modifying anything. Implementations can use this to cache e.g. stat
+ * data or even file content without the need to synchronize with the file
+ * system.
+ */
+#ifndef enable_fscache
+#define enable_fscache(x) /* noop */
+#endif
+
 #endif
diff --git a/preload-index.c b/preload-index.c
index 968ee25eae..8253778c85 100644
--- a/preload-index.c
+++ b/preload-index.c
@@ -84,6 +84,7 @@ static void preload_index(struct index_state *index,
 	offset = 0;
 	work = DIV_ROUND_UP(index->cache_nr, threads);
 	memset(&data, 0, sizeof(data));
+	enable_fscache(1);
 	for (i = 0; i < threads; i++) {
 		struct thread_data *p = data+i;
 		p->index = index;
@@ -100,6 +101,7 @@ static void preload_index(struct index_state *index,
 		if (pthread_join(p->pthread, NULL))
 			die("unable to join threaded lstat");
 	}
+	enable_fscache(0);
 }
 #endif
 
-- 
2.11.4.GIT