#!/bin/sh test_description="Test core.fsmonitor" . ./perf-lib.sh # # Performance test for the fsmonitor feature which enables git to talk to a # file system change monitor and avoid having to scan the working directory # for new or modified files. # # By default, the performance test will utilize the Watchman file system # monitor if it is installed. If Watchman is not installed, it will use a # dummy integration script that does not report any new or modified files. # The dummy script has very little overhead which provides optimistic results. # # The performance test will also use the untracked cache feature if it is # available as fsmonitor uses it to speed up scanning for untracked files. # # There are 3 environment variables that can be used to alter the default # behavior of the performance test: # # GIT_PERF_7519_UNTRACKED_CACHE: used to configure core.untrackedCache # GIT_PERF_7519_SPLIT_INDEX: used to configure core.splitIndex # GIT_PERF_7519_FSMONITOR: used to configure core.fsMonitor. May be an # absolute path to an integration. May be a space delimited list of # absolute paths to integrations. # # The big win for using fsmonitor is the elimination of the need to scan the # working directory looking for changed and untracked files. If the file # information is all cached in RAM, the benefits are reduced. # # GIT_PERF_7519_DROP_CACHE: if set, the OS caches are dropped between tests # # GIT_PERF_7519_TRACE: if set, enable trace logging during the test. # Trace logs will be grouped by fsmonitor provider. test_perf_large_repo test_checkout_worktree test_lazy_prereq UNTRACKED_CACHE ' { git update-index --test-untracked-cache; ret=$?; } && test $ret -ne 1 ' test_lazy_prereq WATCHMAN ' command -v watchman ' if test_have_prereq WATCHMAN then # Convert unix style paths to escaped Windows style paths for Watchman case "$(uname -s)" in MSYS_NT*) GIT_WORK_TREE="$(cygpath -aw "$PWD" | sed 's,\\,/,g')" ;; *) GIT_WORK_TREE="$PWD" ;; esac fi if test -n "$GIT_PERF_7519_DROP_CACHE" then # When using GIT_PERF_7519_DROP_CACHE, GIT_PERF_REPEAT_COUNT must be 1 to # generate valid results. Otherwise the caching that happens for the nth # run will negate the validity of the comparisons. if test "$GIT_PERF_REPEAT_COUNT" -ne 1 then echo "warning: Setting GIT_PERF_REPEAT_COUNT=1" >&2 GIT_PERF_REPEAT_COUNT=1 fi fi trace_start() { if test -n "$GIT_PERF_7519_TRACE" then name="$1" TEST_TRACE_DIR="$TEST_OUTPUT_DIRECTORY/test-trace/p7519/" echo "Writing trace logging to $TEST_TRACE_DIR" mkdir -p "$TEST_TRACE_DIR" # Start Trace2 logging and any other GIT_TRACE_* logs that you # want for this named test case. GIT_TRACE2_PERF="$TEST_TRACE_DIR/$name.trace2perf" export GIT_TRACE2_PERF >"$GIT_TRACE2_PERF" fi } trace_stop() { if test -n "$GIT_PERF_7519_TRACE" then unset GIT_TRACE2_PERF fi } test_expect_success "one time repo setup" ' # set untrackedCache depending on the environment if test -n "$GIT_PERF_7519_UNTRACKED_CACHE" then git config core.untrackedCache "$GIT_PERF_7519_UNTRACKED_CACHE" else if test_have_prereq UNTRACKED_CACHE then git config core.untrackedCache true else git config core.untrackedCache false fi fi && # set core.splitindex depending on the environment if test -n "$GIT_PERF_7519_SPLIT_INDEX" then git config core.splitIndex "$GIT_PERF_7519_SPLIT_INDEX" fi && mkdir 1_file 10_files 100_files 1000_files 10000_files && for i in $(test_seq 1 10); do touch 10_files/$i || return 1; done && for i in $(test_seq 1 100); do touch 100_files/$i || return 1; done && for i in $(test_seq 1 1000); do touch 1000_files/$i || return 1; done && for i in $(test_seq 1 10000); do touch 10000_files/$i || return 1; done && git add 1_file 10_files 100_files 1000_files 10000_files && git commit -qm "Add files" && # If Watchman exists, watch the work tree and attempt a query. if test_have_prereq WATCHMAN; then watchman watch "$GIT_WORK_TREE" && watchman watch-list | grep -q -F "p7519-fsmonitor" fi ' setup_for_fsmonitor() { # set INTEGRATION_SCRIPT depending on the environment if test -n "$INTEGRATION_PATH" then INTEGRATION_SCRIPT="$INTEGRATION_PATH" else # # Choose integration script based on existence of Watchman. # Fall back to an empty integration script. # mkdir .git/hooks && if test_have_prereq WATCHMAN then INTEGRATION_SCRIPT=".git/hooks/fsmonitor-watchman" && cp "$TEST_DIRECTORY/../templates/hooks--fsmonitor-watchman.sample" "$INTEGRATION_SCRIPT" else INTEGRATION_SCRIPT=".git/hooks/fsmonitor-empty" && write_script "$INTEGRATION_SCRIPT"<<-\EOF EOF fi fi && git config core.fsmonitor "$INTEGRATION_SCRIPT" && git update-index --fsmonitor 2>error && if test_have_prereq WATCHMAN then test_must_be_empty error # ensure no silent error else grep "Empty last update token" error fi } test_perf_w_drop_caches () { if test -n "$GIT_PERF_7519_DROP_CACHE"; then test-tool drop-caches fi test_perf "$@" } test_fsmonitor_suite() { if test -n "$INTEGRATION_SCRIPT"; then DESC="fsmonitor=$(basename $INTEGRATION_SCRIPT)" else DESC="fsmonitor=disabled" fi test_expect_success "test_initialization" ' git reset --hard && git status # Warm caches ' test_perf_w_drop_caches "status ($DESC)" ' git status ' test_perf_w_drop_caches "status -uno ($DESC)" ' git status -uno ' test_perf_w_drop_caches "status -uall ($DESC)" ' git status -uall ' # Update the mtimes on upto 100k files to make status think # that they are dirty. For simplicity, omit any files with # LFs (i.e. anything that ls-files thinks it needs to dquote). # Then fully backslash-quote the paths to capture any # whitespace so that they pass thru xargs properly. # test_perf_w_drop_caches "status (dirty) ($DESC)" ' git ls-files | \ head -100000 | \ grep -v \" | \ sed '\''s/\(.\)/\\\1/g'\'' | \ xargs test-tool chmtime -300 && git status ' test_perf_w_drop_caches "diff ($DESC)" ' git diff ' test_perf_w_drop_caches "diff HEAD ($DESC)" ' git diff HEAD ' test_perf_w_drop_caches "diff -- 0_files ($DESC)" ' git diff -- 1_file ' test_perf_w_drop_caches "diff -- 10_files ($DESC)" ' git diff -- 10_files ' test_perf_w_drop_caches "diff -- 100_files ($DESC)" ' git diff -- 100_files ' test_perf_w_drop_caches "diff -- 1000_files ($DESC)" ' git diff -- 1000_files ' test_perf_w_drop_caches "diff -- 10000_files ($DESC)" ' git diff -- 10000_files ' test_perf_w_drop_caches "add ($DESC)" ' git add --all ' } # # Run a full set of perf tests using each Hook-based fsmonitor provider, # such as Watchman. # trace_start fsmonitor-watchman if test -n "$GIT_PERF_7519_FSMONITOR"; then for INTEGRATION_PATH in $GIT_PERF_7519_FSMONITOR; do test_expect_success "setup for fsmonitor $INTEGRATION_PATH" 'setup_for_fsmonitor' test_fsmonitor_suite done else test_expect_success "setup for fsmonitor" 'setup_for_fsmonitor' test_fsmonitor_suite fi if test_have_prereq WATCHMAN then watchman watch-del "$GIT_WORK_TREE" >/dev/null 2>&1 && # Work around Watchman bug on Windows where it holds on to handles # preventing the removal of the trash directory watchman shutdown-server >/dev/null 2>&1 fi trace_stop # # Run a full set of perf tests with the fsmonitor feature disabled. # trace_start fsmonitor-disabled test_expect_success "setup without fsmonitor" ' unset INTEGRATION_SCRIPT && git config --unset core.fsmonitor && git update-index --no-fsmonitor ' test_fsmonitor_suite trace_stop test_done