2008-07-09 20:58:57 +08:00
|
|
|
#ifndef RERERE_H
|
|
|
|
#define RERERE_H
|
|
|
|
|
2023-03-21 14:25:54 +08:00
|
|
|
#include "gettext.h"
|
2008-07-22 02:03:49 +08:00
|
|
|
#include "string-list.h"
|
2008-07-09 20:58:57 +08:00
|
|
|
|
2013-07-14 16:35:40 +08:00
|
|
|
struct pathspec;
|
2018-09-21 23:57:32 +08:00
|
|
|
struct repository;
|
2013-07-14 16:35:40 +08:00
|
|
|
|
2009-12-04 16:20:48 +08:00
|
|
|
#define RERERE_AUTOUPDATE 01
|
|
|
|
#define RERERE_NOAUTOUPDATE 02
|
rerere: release lockfile in non-writing functions
There's a bug in builtin/am.c in which we take a lock on
MERGE_RR recursively. But rather than fix am.c, this patch
fixes the confusing interface from rerere.c that caused the
bug. Read on for the gory details.
The setup_rerere() function both reads the existing MERGE_RR
file, and takes MERGE_RR.lock. In the rerere() and
rerere_forget() functions, we end up in write_rr(), which
will then commit the lock file.
But for functions like rerere_clear() that do not write to
MERGE_RR, we expect the caller to have handled
setup_rerere(). That caller would then need to release the
lockfile, but it can't; the lock struct is local to
rerere.c.
For builtin/rerere.c, this is OK. We run a single rerere
operation and then exit immediately, which has the side
effect of rolling back the lockfile.
But in builtin/am.c, this is actively wrong. If we run "git
am -3 --skip", we call setup-rerere twice without releasing
the lock:
1. The "--skip" causes us to call am_rerere_clear(), which
calls setup_rerere(), but never drops the lock.
2. We then proceed to the next patch.
3. The "--3way" may cause us to call rerere() to handle
conflicts in that patch, but we are already holding the
lock. The lockfile code dies with:
BUG: prepare_tempfile_object called for active object
We could fix this by having rerere_clear() call
rollback_lock_file(). But it feels a bit odd for it to roll
back a lockfile that it did not itself take. So let's
simplify the interface further, and handle setup_rerere in
the function itself, taking away the question from the
caller over whether they need to do so.
We can give rerere_gc() the same treatment, as well (even
though it doesn't have any callers besides builtin/rerere.c
at this point). Note that these functions don't take flags
from their callers to pass along to setup_rerere; that's OK,
because the flags would not be meaningful for what they are
doing.
Both of those functions need to hold the lock because even
though they do not write to MERGE_RR, they are still writing
and should be protected from a simultaneous "rerere" run.
But rerere_remaining(), "rerere diff", and "rerere status"
are all read-only operations. They want to setup_rerere(),
but do not care about taking the lock in the first place.
Since our update of MERGE_RR is the usual atomic rename done
by commit_lock_file, they can just do a lockless read. For
that, we teach setup_rerere a READONLY flag to avoid the
lock.
As a bonus, this pushes builtin/rerere.c's setup_rerere call
closer to the functions that use it. Which means that "git
rerere totally-bogus-command" will no longer silently
exit(0) in a repository without rerere enabled.
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2015-09-02 06:14:09 +08:00
|
|
|
#define RERERE_READONLY 04
|
2009-12-04 16:20:48 +08:00
|
|
|
|
2011-02-16 18:47:44 +08:00
|
|
|
/*
|
|
|
|
* Marks paths that have been hand-resolved and added to the
|
|
|
|
* index. Set in the util field of such paths after calling
|
|
|
|
* rerere_remaining.
|
|
|
|
*/
|
|
|
|
extern void *RERERE_RESOLVED;
|
|
|
|
|
rerere: split conflict ID further
The plan is to keep assigning the backward compatible conflict ID
based on the hash of the (normalized) text of conflicts, keep using
that conflict ID as the directory name under $GIT_DIR/rr-cache/, but
allow each conflicted path to use a separate "variant" to record
resolutions, i.e. having more than one <preimage,postimage> pairs
under $GIT_DIR/rr-cache/$ID/ directory. As the first step in that
direction, separate the shared "conflict ID" out of the rerere_id
structure.
The plan is to keep information per $ID in rerere_dir, that can be
shared among rerere_id that is per conflicted path.
When we are done with rerere(), which can be directly called from
other programs like "git apply", "git commit" and "git merge", the
shared rerere_dir structures can be freed entirely, so they are not
reference-counted and they are not freed when we release rerere_id's
that reference them.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2015-07-17 05:50:05 +08:00
|
|
|
struct rerere_dir;
|
2015-07-05 08:38:34 +08:00
|
|
|
struct rerere_id {
|
rerere: split conflict ID further
The plan is to keep assigning the backward compatible conflict ID
based on the hash of the (normalized) text of conflicts, keep using
that conflict ID as the directory name under $GIT_DIR/rr-cache/, but
allow each conflicted path to use a separate "variant" to record
resolutions, i.e. having more than one <preimage,postimage> pairs
under $GIT_DIR/rr-cache/$ID/ directory. As the first step in that
direction, separate the shared "conflict ID" out of the rerere_id
structure.
The plan is to keep information per $ID in rerere_dir, that can be
shared among rerere_id that is per conflicted path.
When we are done with rerere(), which can be directly called from
other programs like "git apply", "git commit" and "git merge", the
shared rerere_dir structures can be freed entirely, so they are not
reference-counted and they are not freed when we release rerere_id's
that reference them.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2015-07-17 05:50:05 +08:00
|
|
|
struct rerere_dir *collection;
|
2015-07-24 05:23:24 +08:00
|
|
|
int variant;
|
2015-07-05 08:38:34 +08:00
|
|
|
};
|
|
|
|
|
2018-11-10 13:49:09 +08:00
|
|
|
int setup_rerere(struct repository *,struct string_list *, int);
|
2018-09-21 23:57:32 +08:00
|
|
|
int repo_rerere(struct repository *, int);
|
2015-07-05 08:38:34 +08:00
|
|
|
/*
|
|
|
|
* Given the conflict ID and the name of a "file" used for replaying
|
|
|
|
* the recorded resolution (e.g. "preimage", "postimage"), return the
|
|
|
|
* path to that filesystem entity. With "file" specified with NULL,
|
|
|
|
* return the path to the directory that houses these files.
|
|
|
|
*/
|
2018-06-30 17:20:28 +08:00
|
|
|
const char *rerere_path(const struct rerere_id *, const char *file);
|
2018-09-21 23:57:32 +08:00
|
|
|
int rerere_forget(struct repository *, struct pathspec *);
|
|
|
|
int rerere_remaining(struct repository *, struct string_list *);
|
2018-11-10 13:49:09 +08:00
|
|
|
void rerere_clear(struct repository *, struct string_list *);
|
|
|
|
void rerere_gc(struct repository *, struct string_list *);
|
2008-07-09 20:58:57 +08:00
|
|
|
|
2009-12-04 16:20:48 +08:00
|
|
|
#define OPT_RERERE_AUTOUPDATE(v) OPT_UYN(0, "rerere-autoupdate", (v), \
|
2014-09-15 06:40:53 +08:00
|
|
|
N_("update the index with reused conflict resolution if possible"))
|
2009-12-04 16:20:48 +08:00
|
|
|
|
2008-07-09 20:58:57 +08:00
|
|
|
#endif
|