PostIndexChangedHook: skip notification for non-canonical indexes#1940
Merged
tyrielv merged 1 commit intoApr 9, 2026
Merged
Conversation
0f47bf2 to
0b3255d
Compare
0b3255d to
4b70348
Compare
Git fires the post-index-change hook for every index write, including temp indexes created via GIT_INDEX_FILE redirect (e.g. read-tree --index-output, git add with a temp index). The GVFS mount process only needs to know about changes to the real `\$GIT_DIR/index`. When writing a 194MB temp index (2.47M entries), the hook's pipe round-trip to the GVFS mount process adds ~5s of overhead per read-tree/add call — a significant regression for tools that use the temp-index flow. Add an early-exit check in IsNonCanonicalIndex() that resolves both GIT_INDEX_FILE and `\$GIT_DIR/index` to absolute paths via GetFullPathNameA, then compares case-insensitively. If they differ, the hook exits immediately without contacting the mount process. When the environment is unexpected (GIT_DIR absent, path resolution fails), we err on the side of correctness and proceed with the notification rather than silently suppressing it. Unit tests invoke the hook exe with controlled environment variables and WorkingDirectory set to %TEMP% (outside any GVFS mount) to verify: - temp index paths (should skip) - canonical index paths (should NOT skip, exits NotInGVFSEnlistment) - missing GIT_DIR (should NOT skip) - mixed separators and case (normalization via GetFullPathNameA) Note: the ideal long-term fix is in Git's do_write_locked_index() (read-cache.c) to skip firing the hook entirely for non-default indexes, avoiding the process spawn altogether. Assisted-by: Claude Opus 4.6 Signed-off-by: Tyrie Vella <tyrielv@gmail.com>
KeithIsSleeping
approved these changes
Apr 9, 2026
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PostIndexChangedHook: skip notification for non-canonical indexes
Problem
Git fires the
post-index-changehook for every index write, including temp indexes created viaGIT_INDEX_FILEredirect (e.g.read-tree --index-output,git addwith a temp index). The GVFSpost-index-change.exehook connects to the mount process via named pipe and waits for acknowledgment — a round-trip that takes ~5 seconds for large repos.Root Cause
read-cache.c→do_write_locked_index()run_hooks_l("post-index-change", ...)unconditionally — no check for temp vs. real indexGVFS.PostIndexChangedHook/main.cppWhy COMMAND_HOOK_LOCK doesn't help
The GVFS command lock (pre/post-command in
GVFS.Hooks.exe) is a separate mechanism.post-index-changeis fired independently by Git's hook runner. Additionally,hook.c'shandle_hook_replacement()explicitly states: "We don't skip post-index-change hooks that exist."Fix
Added
IsNonCanonicalIndex()early-exit check inmain.cpp:GIT_INDEX_FILEfrom environment$GIT_DIR/index(normalized separators, case-insensitive)Effect: Hook process still spawns (Git-side fires it unconditionally) but exits in <1ms instead of ~5s.
Ideal long-term fix
I think the correct fix would be in Git's
do_write_locked_index()(microsoft/gitfork,read-cache.c) to skip firing the hook entirely for non-default indexes, avoiding the process spawn altogether. This PR is the GVFS-side mitigation.Testing
GIT_INDEX_FILEto a temp path → hook exits immediately