3 test_description="Test core.fsmonitor"
8 # Performance test for the fsmonitor feature which enables git to talk to a
9 # file system change monitor and avoid having to scan the working directory
10 # for new or modified files.
12 # By default, the performance test will utilize the Watchman file system
13 # monitor if it is installed. If Watchman is not installed, it will use a
14 # dummy integration script that does not report any new or modified files.
15 # The dummy script has very little overhead which provides optimistic results.
17 # The performance test will also use the untracked cache feature if it is
18 # available as fsmonitor uses it to speed up scanning for untracked files.
20 # There are 3 environment variables that can be used to alter the default
21 # behavior of the performance test:
23 # GIT_PERF_7519_UNTRACKED_CACHE: used to configure core.untrackedCache
24 # GIT_PERF_7519_SPLIT_INDEX: used to configure core.splitIndex
25 # GIT_PERF_7519_FSMONITOR: used to configure core.fsMonitor
27 # The big win for using fsmonitor is the elimination of the need to scan the
28 # working directory looking for changed and untracked files. If the file
29 # information is all cached in RAM, the benefits are reduced.
31 # GIT_PERF_7519_DROP_CACHE: if set, the OS caches are dropped between tests
35 test_checkout_worktree
37 test_lazy_prereq UNTRACKED_CACHE '
38 { git update-index --test-untracked-cache; ret=$?; } &&
42 test_lazy_prereq WATCHMAN '
43 { command -v watchman >/dev/null 2>&1; ret=$?; } &&
47 if test_have_prereq WATCHMAN
49 # Convert unix style paths to escaped Windows style paths for Watchman
52 GIT_WORK_TREE="$(cygpath -aw "$PWD" | sed 's,\\,/,g')"
60 if test -n "$GIT_PERF_7519_DROP_CACHE"
62 # When using GIT_PERF_7519_DROP_CACHE, GIT_PERF_REPEAT_COUNT must be 1 to
63 # generate valid results. Otherwise the caching that happens for the nth
64 # run will negate the validity of the comparisons.
65 if test "$GIT_PERF_REPEAT_COUNT" -ne 1
67 echo "warning: Setting GIT_PERF_REPEAT_COUNT=1" >&2
68 GIT_PERF_REPEAT_COUNT=1
72 test_expect_success "setup for fsmonitor" '
73 # set untrackedCache depending on the environment
74 if test -n "$GIT_PERF_7519_UNTRACKED_CACHE"
76 git config core.untrackedCache "$GIT_PERF_7519_UNTRACKED_CACHE"
78 if test_have_prereq UNTRACKED_CACHE
80 git config core.untrackedCache true
82 git config core.untrackedCache false
86 # set core.splitindex depending on the environment
87 if test -n "$GIT_PERF_7519_SPLIT_INDEX"
89 git config core.splitIndex "$GIT_PERF_7519_SPLIT_INDEX"
92 # set INTEGRATION_SCRIPT depending on the environment
93 if test -n "$GIT_PERF_7519_FSMONITOR"
95 INTEGRATION_SCRIPT="$GIT_PERF_7519_FSMONITOR"
98 # Choose integration script based on existence of Watchman.
99 # If Watchman exists, watch the work tree and attempt a query.
100 # If everything succeeds, use Watchman integration script,
101 # else fall back to an empty integration script.
104 if test_have_prereq WATCHMAN
106 INTEGRATION_SCRIPT=".git/hooks/fsmonitor-watchman" &&
107 cp "$TEST_DIRECTORY/../templates/hooks--fsmonitor-watchman.sample" "$INTEGRATION_SCRIPT" &&
108 watchman watch "$GIT_WORK_TREE" &&
109 watchman watch-list | grep -q -F "$GIT_WORK_TREE"
111 INTEGRATION_SCRIPT=".git/hooks/fsmonitor-empty" &&
112 write_script "$INTEGRATION_SCRIPT"<<-\EOF
117 git config core.fsmonitor "$INTEGRATION_SCRIPT" &&
118 git update-index --fsmonitor
121 if test -n "$GIT_PERF_7519_DROP_CACHE"; then
125 test_perf "status (fsmonitor=$INTEGRATION_SCRIPT)" '
129 if test -n "$GIT_PERF_7519_DROP_CACHE"; then
133 test_perf "status -uno (fsmonitor=$INTEGRATION_SCRIPT)" '
137 if test -n "$GIT_PERF_7519_DROP_CACHE"; then
141 test_perf "status -uall (fsmonitor=$INTEGRATION_SCRIPT)" '
145 test_expect_success "setup without fsmonitor" '
146 unset INTEGRATION_SCRIPT &&
147 git config --unset core.fsmonitor &&
148 git update-index --no-fsmonitor
151 if test -n "$GIT_PERF_7519_DROP_CACHE"; then
155 test_perf "status (fsmonitor=$INTEGRATION_SCRIPT)" '
159 if test -n "$GIT_PERF_7519_DROP_CACHE"; then
163 test_perf "status -uno (fsmonitor=$INTEGRATION_SCRIPT)" '
167 if test -n "$GIT_PERF_7519_DROP_CACHE"; then
171 test_perf "status -uall (fsmonitor=$INTEGRATION_SCRIPT)" '
175 if test_have_prereq WATCHMAN
177 watchman watch-del "$GIT_WORK_TREE" >/dev/null 2>&1 &&
179 # Work around Watchman bug on Windows where it holds on to handles
180 # preventing the removal of the trash directory
181 watchman shutdown-server >/dev/null 2>&1