hook: mark non-parallelizable hooks
Several hooks are known to be inherently non-parallelizable, so initialize them with RUN_HOOKS_OPT_INIT_FORCE_SERIAL. This pins jobs=1 and overrides any hook.jobs or runtime -j flags. These hooks are: applypatch-msg, pre-commit, prepare-commit-msg, commit-msg, post-commit, post-checkout, and push-to-checkout. Signed-off-by: Emily Shaffer <emilyshaffer@google.com> Signed-off-by: Adrian Ratiu <adrian.ratiu@collabora.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Emily Shaffer committed
Apr 10, 2026 at 12:06 UTC
ae25764e50f38b6625e11c3a7d7de290a0075b9c
8 files changed
+56
-14
Documentation/config/hook.adoc
+14
@@ -36,6 +36,20 @@ hook.<friendly-name>.parallel::
36
hook.jobs::
37
Specifies how many hooks can be run simultaneously during parallelized
38
hook execution. If unspecified, defaults to 1 (serial execution).
39
+ Some hooks always run sequentially regardless of this setting because
40
+ they operate on shared data and cannot safely be parallelized:
41
++
42
+--
43
+`applypatch-msg`;;
44
+`prepare-commit-msg`;;
45
+`commit-msg`;;
46
+ Receive a commit message file and may rewrite it in place.
47
+`pre-commit`;;
48
+`post-checkout`;;
49
+`push-to-checkout`;;
50
+`post-commit`;;
51
+ Access the working tree, index, or repository state.
52
+--
53
+
54
This setting has no effect unless all configured hooks for the event have
55
`hook.<friendly-name>.parallel` set to `true`.
builtin/am.c
+5
-3
@@ -490,9 +490,11 @@ static int run_applypatch_msg_hook(struct am_state *state)
490
491
assert(state->msg);
492
493
- if (!state->no_verify)
494
- ret = run_hooks_l(the_repository, "applypatch-msg",
495
- am_path(state, "final-commit"), NULL);
493
+ if (!state->no_verify) {
494
+ struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT_FORCE_SERIAL;
495
+ strvec_push(&opt.args, am_path(state, "final-commit"));
496
+ ret = run_hooks_opt(the_repository, "applypatch-msg", &opt);
497
+ }
498
499
if (!ret) {
500
FREE_AND_NULL(state->msg);
builtin/checkout.c
+13
-6
@@ -31,6 +31,7 @@
31
#include "resolve-undo.h"
32
#include "revision.h"
33
#include "setup.h"
34
+#include "strvec.h"
35
#include "submodule.h"
36
#include "symlinks.h"
37
#include "trace2.h"
@@ -123,13 +124,19 @@ static void branch_info_release(struct branch_info *info)
124
static int post_checkout_hook(struct commit *old_commit, struct commit *new_commit,
125
int changed)
126
{
126
- return run_hooks_l(the_repository, "post-checkout",
127
- oid_to_hex(old_commit ? &old_commit->object.oid : null_oid(the_hash_algo)),
128
- oid_to_hex(new_commit ? &new_commit->object.oid : null_oid(the_hash_algo)),
129
- changed ? "1" : "0", NULL);
130
- /* "new_commit" can be NULL when checking out from the index before
131
- a commit exists. */
127
+ struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT_FORCE_SERIAL;
128
129
+ /*
130
+ * "new_commit" can be NULL when checking out from the index before
131
+ * a commit exists.
132
+ */
133
+ strvec_pushl(&opt.args,
134
+ oid_to_hex(old_commit ? &old_commit->object.oid : null_oid(the_hash_algo)),
135
+ oid_to_hex(new_commit ? &new_commit->object.oid : null_oid(the_hash_algo)),
136
+ changed ? "1" : "0",
137
+ NULL);
138
+
139
+ return run_hooks_opt(the_repository, "post-checkout", &opt);
140
}
141
142
static int update_some(const struct object_id *oid, struct strbuf *base,
builtin/clone.c
+4
-2
@@ -647,6 +647,7 @@ static int checkout(int submodule_progress,
647
struct tree *tree;
648
struct tree_desc t;
649
int err = 0;
650
+ struct run_hooks_opt hook_opt = RUN_HOOKS_OPT_INIT_FORCE_SERIAL;
651
652
if (option_no_checkout)
653
return 0;
@@ -697,8 +698,9 @@ static int checkout(int submodule_progress,
698
if (write_locked_index(the_repository->index, &lock_file, COMMIT_LOCK))
699
die(_("unable to write new index file"));
700
700
- err |= run_hooks_l(the_repository, "post-checkout", oid_to_hex(null_oid(the_hash_algo)),
701
- oid_to_hex(&oid), "1", NULL);
701
+ strvec_pushl(&hook_opt.args, oid_to_hex(null_oid(the_hash_algo)),
702
+ oid_to_hex(&oid), "1", NULL);
703
+ err |= run_hooks_opt(the_repository, "post-checkout", &hook_opt);
704
705
if (!err && (option_recurse_submodules.nr > 0)) {
706
struct child_process cmd = CHILD_PROCESS_INIT;
builtin/receive-pack.c
+2
-1
@@ -1455,7 +1455,8 @@ static const char *push_to_checkout(unsigned char *hash,
1455
struct strvec *env,
1456
const char *work_tree)
1457
{
1458
- struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT;
1458
+ struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT_FORCE_SERIAL;
1459
+
1460
opt.invoked_hook = invoked_hook;
1461
1462
strvec_pushf(env, "GIT_WORK_TREE=%s", absolute_path(work_tree));
builtin/worktree.c
+1
-1
@@ -609,7 +609,7 @@ done:
609
* is_junk is cleared, but do return appropriate code when hook fails.
610
*/
611
if (!ret && opts->checkout && !opts->orphan) {
612
- struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT;
612
+ struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT_FORCE_SERIAL;
613
614
strvec_pushl(&opt.env, "GIT_DIR", "GIT_WORK_TREE", NULL);
615
strvec_pushl(&opt.args,
commit.c
+1
-1
@@ -1970,7 +1970,7 @@ size_t ignored_log_message_bytes(const char *buf, size_t len)
1970
int run_commit_hook(int editor_is_used, const char *index_file,
1971
int *invoked_hook, const char *name, ...)
1972
{
1973
- struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT;
1973
+ struct run_hooks_opt opt = RUN_HOOKS_OPT_INIT_FORCE_SERIAL;
1974
va_list args;
1975
const char *arg;
1976
t/t1800-hook.sh
+16
@@ -832,4 +832,20 @@ test_expect_success 'client hooks: pre-push runs in parallel when hook.jobs > 1'
832
test_cmp expect repo-parallel/hook.order
833
'
834
835
+test_expect_success 'hook.jobs=2 is ignored for force-serial hooks (pre-commit)' '
836
+ test_when_finished "rm -f sentinel.started sentinel.done hook.order" &&
837
+ test_config hook.hook-1.event pre-commit &&
838
+ test_config hook.hook-1.command \
839
+ "touch sentinel.started; sleep 2; touch sentinel.done" &&
840
+ test_config hook.hook-1.parallel true &&
841
+ test_config hook.hook-2.event pre-commit &&
842
+ test_config hook.hook-2.command \
843
+ "$(sentinel_detector sentinel hook.order)" &&
844
+ test_config hook.hook-2.parallel true &&
845
+ test_config hook.jobs 2 &&
846
+ git commit --allow-empty -m "test: verify force-serial on pre-commit" &&
847
+ echo serial >expect &&
848
+ test_cmp expect hook.order
849
+'
850
+
851
test_done