2 * Helper functions for tree diff generation
10 * internal mode marker, saying a tree entry != entry of tp[imin]
11 * (see ll_diff_tree_paths for what it means there)
13 * we will update/use/emit entry for diff only with it unset.
15 #define S_IFXMIN_NEQ S_DIFFTREE_IFXMIN_NEQ
17 #define FAST_ARRAY_ALLOC(x, nr) do { \
19 (x) = xalloca((nr) * sizeof(*(x))); \
21 ALLOC_ARRAY((x), nr); \
23 #define FAST_ARRAY_FREE(x, nr) do { \
28 static struct combine_diff_path
*ll_diff_tree_paths(
29 struct combine_diff_path
*p
, const struct object_id
*oid
,
30 const struct object_id
**parents_oid
, int nparent
,
31 struct strbuf
*base
, struct diff_options
*opt
);
32 static int ll_diff_tree_oid(const struct object_id
*old_oid
,
33 const struct object_id
*new_oid
,
34 struct strbuf
*base
, struct diff_options
*opt
);
37 * Compare two tree entries, taking into account only path/S_ISDIR(mode),
38 * but not their sha1's.
40 * NOTE files and directories *always* compare differently, even when having
41 * the same name - thanks to base_name_compare().
43 * NOTE empty (=invalid) descriptor(s) take part in comparison as +infty,
44 * so that they sort *after* valid tree entries.
46 * Due to this convention, if trees are scanned in sorted order, all
47 * non-empty descriptors will be processed first.
49 static int tree_entry_pathcmp(struct tree_desc
*t1
, struct tree_desc
*t2
)
51 struct name_entry
*e1
, *e2
;
54 /* empty descriptors sort after valid tree entries */
56 return t2
->size
? 1 : 0;
62 cmp
= base_name_compare(e1
->path
, tree_entry_len(e1
), e1
->mode
,
63 e2
->path
, tree_entry_len(e2
), e2
->mode
);
69 * convert path -> opt->diff_*() callbacks
71 * emits diff to first parent only, and tells diff tree-walker that we are done
72 * with p and it can be freed.
74 static int emit_diff_first_parent_only(struct diff_options
*opt
, struct combine_diff_path
*p
)
76 struct combine_diff_parent
*p0
= &p
->parent
[0];
77 if (p
->mode
&& p0
->mode
) {
78 opt
->change(opt
, p0
->mode
, p
->mode
, &p0
->oid
, &p
->oid
,
82 const struct object_id
*oid
;
96 opt
->add_remove(opt
, addremove
, mode
, oid
, 1, p
->path
, 0);
99 return 0; /* we are done with p */
104 * Make a new combine_diff_path from path/mode/sha1
105 * and append it to paths list tail.
107 * Memory for created elements could be reused:
109 * - if last->next == NULL, the memory is allocated;
111 * - if last->next != NULL, it is assumed that p=last->next was returned
112 * earlier by this function, and p->next was *not* modified.
113 * The memory is then reused from p.
117 * - if you do need to keep the element
119 * p = path_appendnew(p, ...);
123 * - if you don't need to keep the element after processing
126 * p = path_appendnew(p, ...);
129 * ; don't forget to free tail->next in the end
131 * p->parent[] remains uninitialized.
133 static struct combine_diff_path
*path_appendnew(struct combine_diff_path
*last
,
134 int nparent
, const struct strbuf
*base
, const char *path
, int pathlen
,
135 unsigned mode
, const struct object_id
*oid
)
137 struct combine_diff_path
*p
;
138 size_t len
= st_add(base
->len
, pathlen
);
139 size_t alloclen
= combine_diff_path_size(nparent
, len
);
141 /* if last->next is !NULL - it is a pre-allocated memory, we can reuse */
143 if (p
&& (alloclen
> (intptr_t)p
->next
)) {
148 p
= xmalloc(alloclen
);
151 * until we go to it next round, .next holds how many bytes we
152 * allocated (for faster realloc - we don't need copying old data).
154 p
->next
= (struct combine_diff_path
*)(intptr_t)alloclen
;
159 p
->path
= (char *)&(p
->parent
[nparent
]);
160 memcpy(p
->path
, base
->buf
, base
->len
);
161 memcpy(p
->path
+ base
->len
, path
, pathlen
);
164 oidcpy(&p
->oid
, oid
? oid
: &null_oid
);
170 * new path should be added to combine diff
172 * 3 cases on how/when it should be called and behaves:
174 * t, !tp -> path added, all parents lack it
175 * !t, tp -> path removed from all parents
176 * t, tp -> path modified/added
177 * (M for tp[i]=tp[imin], A otherwise)
179 static struct combine_diff_path
*emit_path(struct combine_diff_path
*p
,
180 struct strbuf
*base
, struct diff_options
*opt
, int nparent
,
181 struct tree_desc
*t
, struct tree_desc
*tp
,
186 const struct object_id
*oid
;
188 int old_baselen
= base
->len
;
189 int i
, isdir
, recurse
= 0, emitthis
= 1;
191 /* at least something has to be valid */
195 /* path present in resulting tree */
196 oid
= tree_entry_extract(t
, &path
, &mode
);
197 pathlen
= tree_entry_len(&t
->entry
);
198 isdir
= S_ISDIR(mode
);
201 * a path was removed - take path from imin parent. Also take
202 * mode from that parent, to decide on recursion(1).
204 * 1) all modes for tp[i]=tp[imin] should be the same wrt
205 * S_ISDIR, thanks to base_name_compare().
207 tree_entry_extract(&tp
[imin
], &path
, &mode
);
208 pathlen
= tree_entry_len(&tp
[imin
].entry
);
210 isdir
= S_ISDIR(mode
);
215 if (DIFF_OPT_TST(opt
, RECURSIVE
) && isdir
) {
217 emitthis
= DIFF_OPT_TST(opt
, TREE_IN_RECURSIVE
);
222 struct combine_diff_path
*pprev
= p
;
223 p
= path_appendnew(p
, nparent
, base
, path
, pathlen
, mode
, oid
);
225 for (i
= 0; i
< nparent
; ++i
) {
227 * tp[i] is valid, if present and if tp[i]==tp[imin] -
228 * otherwise, we should ignore it.
230 int tpi_valid
= tp
&& !(tp
[i
].entry
.mode
& S_IFXMIN_NEQ
);
232 const struct object_id
*oid_i
;
235 p
->parent
[i
].status
=
236 !t
? DIFF_STATUS_DELETED
:
238 DIFF_STATUS_MODIFIED
:
242 oid_i
= tp
[i
].entry
.oid
;
243 mode_i
= tp
[i
].entry
.mode
;
250 p
->parent
[i
].mode
= mode_i
;
251 oidcpy(&p
->parent
[i
].oid
, oid_i
);
256 keep
= opt
->pathchange(opt
, p
);
259 * If a path was filtered or consumed - we don't need to add it
260 * to the list and can reuse its memory, leaving it as
261 * pre-allocated element on the tail.
263 * On the other hand, if path needs to be kept, we need to
264 * correct its .next to NULL, as it was pre-initialized to how
265 * much memory was allocated.
267 * see path_appendnew() for details.
276 const struct object_id
**parents_oid
;
278 FAST_ARRAY_ALLOC(parents_oid
, nparent
);
279 for (i
= 0; i
< nparent
; ++i
) {
280 /* same rule as in emitthis */
281 int tpi_valid
= tp
&& !(tp
[i
].entry
.mode
& S_IFXMIN_NEQ
);
283 parents_oid
[i
] = tpi_valid
? tp
[i
].entry
.oid
: NULL
;
286 strbuf_add(base
, path
, pathlen
);
287 strbuf_addch(base
, '/');
288 p
= ll_diff_tree_paths(p
, oid
, parents_oid
, nparent
, base
, opt
);
289 FAST_ARRAY_FREE(parents_oid
, nparent
);
292 strbuf_setlen(base
, old_baselen
);
296 static void skip_uninteresting(struct tree_desc
*t
, struct strbuf
*base
,
297 struct diff_options
*opt
)
299 enum interesting match
;
302 match
= tree_entry_interesting(&t
->entry
, base
, 0, &opt
->pathspec
);
304 if (match
== all_entries_not_interesting
)
308 update_tree_entry(t
);
314 * generate paths for combined diff D(sha1,parents_oid[])
316 * Resulting paths are appended to combine_diff_path linked list, and also, are
317 * emitted on the go via opt->pathchange() callback, so it is possible to
318 * process the result as batch or incrementally.
320 * The paths are generated scanning new tree and all parents trees
321 * simultaneously, similarly to what diff_tree() was doing for 2 trees.
322 * The theory behind such scan is as follows:
325 * D(T,P1...Pn) calculation scheme
326 * -------------------------------
328 * D(T,P1...Pn) = D(T,P1) ^ ... ^ D(T,Pn) (regarding resulting paths set)
330 * D(T,Pj) - diff between T..Pj
331 * D(T,P1...Pn) - combined diff from T to parents P1,...,Pn
334 * We start from all trees, which are sorted, and compare their entries in
340 * |-| |--| ... |--| imin = argmin(p1...pn)
347 * at any time there could be 3 cases:
353 * Schematic deduction of what every case means, and what to do, follows:
355 * 1) t < p[imin] -> ∀j t ∉ Pj -> "+t" ∈ D(T,Pj) -> D += "+t"; t↓
359 * 2.1) ∃j: pj > p[imin] -> "-p[imin]" ∉ D(T,Pj) -> D += ø; ∀ pi=p[imin] pi↓
360 * 2.2) ∀i pi = p[imin] -> pi ∉ T -> "-pi" ∈ D(T,Pi) -> D += "-p[imin]"; ∀i pi↓
364 * 3.1) ∃j: pj > p[imin] -> "+t" ∈ D(T,Pj) -> only pi=p[imin] remains to investigate
365 * 3.2) pi = p[imin] -> investigate δ(t,pi)
370 * 3.1+3.2) looking at δ(t,pi) ∀i: pi=p[imin] - if all != ø ->
372 * ⎧δ(t,pi) - if pi=p[imin]
374 * ⎩"+t" - if pi>p[imin]
377 * in any case t↓ ∀ pi=p[imin] pi↓
384 * Usual diff D(A,B) is by definition the same as combined diff D(A,[B]),
385 * so this diff paths generator can, and is used, for plain diffs
388 * Please keep attention to the common D(A,[B]) case when working on the
389 * code, in order not to slow it down.
392 * nparent must be > 0.
396 /* ∀ pi=p[imin] pi↓ */
397 static inline void update_tp_entries(struct tree_desc
*tp
, int nparent
)
400 for (i
= 0; i
< nparent
; ++i
)
401 if (!(tp
[i
].entry
.mode
& S_IFXMIN_NEQ
))
402 update_tree_entry(&tp
[i
]);
405 static struct combine_diff_path
*ll_diff_tree_paths(
406 struct combine_diff_path
*p
, const struct object_id
*oid
,
407 const struct object_id
**parents_oid
, int nparent
,
408 struct strbuf
*base
, struct diff_options
*opt
)
410 struct tree_desc t
, *tp
;
411 void *ttree
, **tptree
;
414 FAST_ARRAY_ALLOC(tp
, nparent
);
415 FAST_ARRAY_ALLOC(tptree
, nparent
);
418 * load parents first, as they are probably already cached.
420 * ( log_tree_diff() parses commit->parent before calling here via
421 * diff_tree_oid(parent, commit) )
423 for (i
= 0; i
< nparent
; ++i
)
424 tptree
[i
] = fill_tree_descriptor(&tp
[i
],
425 parents_oid
[i
] ? parents_oid
[i
]->hash
: NULL
);
426 ttree
= fill_tree_descriptor(&t
, oid
? oid
->hash
: NULL
);
428 /* Enable recursion indefinitely */
429 opt
->pathspec
.recursive
= DIFF_OPT_TST(opt
, RECURSIVE
);
434 if (diff_can_quit_early(opt
))
437 if (opt
->pathspec
.nr
) {
438 skip_uninteresting(&t
, base
, opt
);
439 for (i
= 0; i
< nparent
; i
++)
440 skip_uninteresting(&tp
[i
], base
, opt
);
443 /* comparing is finished when all trees are done */
446 for (i
= 0; i
< nparent
; ++i
)
456 * lookup imin = argmin(p1...pn),
457 * mark entries whether they =p[imin] along the way
460 tp
[0].entry
.mode
&= ~S_IFXMIN_NEQ
;
462 for (i
= 1; i
< nparent
; ++i
) {
463 cmp
= tree_entry_pathcmp(&tp
[i
], &tp
[imin
]);
466 tp
[i
].entry
.mode
&= ~S_IFXMIN_NEQ
;
469 tp
[i
].entry
.mode
&= ~S_IFXMIN_NEQ
;
472 tp
[i
].entry
.mode
|= S_IFXMIN_NEQ
;
476 /* fixup markings for entries before imin */
477 for (i
= 0; i
< imin
; ++i
)
478 tp
[i
].entry
.mode
|= S_IFXMIN_NEQ
; /* pi > p[imin] */
482 /* compare t vs p[imin] */
483 cmp
= tree_entry_pathcmp(&t
, &tp
[imin
]);
487 /* are either pi > p[imin] or diff(t,pi) != ø ? */
488 if (!DIFF_OPT_TST(opt
, FIND_COPIES_HARDER
)) {
489 for (i
= 0; i
< nparent
; ++i
) {
491 if (tp
[i
].entry
.mode
& S_IFXMIN_NEQ
)
494 /* diff(t,pi) != ø */
495 if (oidcmp(t
.entry
.oid
, tp
[i
].entry
.oid
) ||
496 (t
.entry
.mode
!= tp
[i
].entry
.mode
))
503 /* D += {δ(t,pi) if pi=p[imin]; "+a" if pi > p[imin]} */
504 p
= emit_path(p
, base
, opt
, nparent
,
508 /* t↓, ∀ pi=p[imin] pi↓ */
509 update_tree_entry(&t
);
510 update_tp_entries(tp
, nparent
);
516 p
= emit_path(p
, base
, opt
, nparent
,
517 &t
, /*tp=*/NULL
, -1);
520 update_tree_entry(&t
);
525 /* ∀i pi=p[imin] -> D += "-p[imin]" */
526 if (!DIFF_OPT_TST(opt
, FIND_COPIES_HARDER
)) {
527 for (i
= 0; i
< nparent
; ++i
)
528 if (tp
[i
].entry
.mode
& S_IFXMIN_NEQ
)
532 p
= emit_path(p
, base
, opt
, nparent
,
533 /*t=*/NULL
, tp
, imin
);
536 /* ∀ pi=p[imin] pi↓ */
537 update_tp_entries(tp
, nparent
);
542 for (i
= nparent
-1; i
>= 0; i
--)
544 FAST_ARRAY_FREE(tptree
, nparent
);
545 FAST_ARRAY_FREE(tp
, nparent
);
550 struct combine_diff_path
*diff_tree_paths(
551 struct combine_diff_path
*p
, const struct object_id
*oid
,
552 const struct object_id
**parents_oid
, int nparent
,
553 struct strbuf
*base
, struct diff_options
*opt
)
555 p
= ll_diff_tree_paths(p
, oid
, parents_oid
, nparent
, base
, opt
);
558 * free pre-allocated last element, if any
559 * (see path_appendnew() for details about why)
562 FREE_AND_NULL(p
->next
);
569 * Does it look like the resulting diff might be due to a rename?
571 * - not a valid previous file
573 static inline int diff_might_be_rename(void)
575 return diff_queued_diff
.nr
== 1 &&
576 !DIFF_FILE_VALID(diff_queued_diff
.queue
[0]->one
);
579 static void try_to_follow_renames(const struct object_id
*old_oid
,
580 const struct object_id
*new_oid
,
581 struct strbuf
*base
, struct diff_options
*opt
)
583 struct diff_options diff_opts
;
584 struct diff_queue_struct
*q
= &diff_queued_diff
;
585 struct diff_filepair
*choice
;
589 * follow-rename code is very specific, we need exactly one
590 * path. Magic that matches more than one path is not
593 GUARD_PATHSPEC(&opt
->pathspec
, PATHSPEC_FROMTOP
| PATHSPEC_LITERAL
);
596 * We should reject wildcards as well. Unfortunately we
597 * haven't got a reliable way to detect that 'foo\*bar' in
598 * fact has no wildcards. nowildcard_len is merely a hint for
599 * optimization. Let it slip for now until wildmatch is taught
600 * about dry-run mode and returns wildcard info.
602 if (opt
->pathspec
.has_wildcard
)
603 die("BUG:%s:%d: wildcards are not supported",
607 /* Remove the file creation entry from the diff queue, and remember it */
608 choice
= q
->queue
[0];
611 diff_setup(&diff_opts
);
612 DIFF_OPT_SET(&diff_opts
, RECURSIVE
);
613 DIFF_OPT_SET(&diff_opts
, FIND_COPIES_HARDER
);
614 diff_opts
.output_format
= DIFF_FORMAT_NO_OUTPUT
;
615 diff_opts
.single_follow
= opt
->pathspec
.items
[0].match
;
616 diff_opts
.break_opt
= opt
->break_opt
;
617 diff_opts
.rename_score
= opt
->rename_score
;
618 diff_setup_done(&diff_opts
);
619 ll_diff_tree_oid(old_oid
, new_oid
, base
, &diff_opts
);
620 diffcore_std(&diff_opts
);
621 clear_pathspec(&diff_opts
.pathspec
);
623 /* Go through the new set of filepairing, and see if we find a more interesting one */
624 opt
->found_follow
= 0;
625 for (i
= 0; i
< q
->nr
; i
++) {
626 struct diff_filepair
*p
= q
->queue
[i
];
629 * Found a source? Not only do we use that for the new
630 * diff_queued_diff, we will also use that as the path in
633 if ((p
->status
== 'R' || p
->status
== 'C') &&
634 !strcmp(p
->two
->path
, opt
->pathspec
.items
[0].match
)) {
637 /* Switch the file-pairs around */
638 q
->queue
[i
] = choice
;
641 /* Update the path we use from now on.. */
642 path
[0] = p
->one
->path
;
644 clear_pathspec(&opt
->pathspec
);
645 parse_pathspec(&opt
->pathspec
,
646 PATHSPEC_ALL_MAGIC
& ~PATHSPEC_LITERAL
,
647 PATHSPEC_LITERAL_PATH
, "", path
);
650 * The caller expects us to return a set of vanilla
651 * filepairs to let a later call to diffcore_std()
652 * it makes to sort the renames out (among other
653 * things), but we already have found renames
654 * ourselves; signal diffcore_std() not to muck with
655 * rename information.
657 opt
->found_follow
= 1;
663 * Then, discard all the non-relevant file pairs...
665 for (i
= 0; i
< q
->nr
; i
++) {
666 struct diff_filepair
*p
= q
->queue
[i
];
667 diff_free_filepair(p
);
671 * .. and re-instate the one we want (which might be either the
672 * original one, or the rename/copy we found)
674 q
->queue
[0] = choice
;
678 static int ll_diff_tree_oid(const struct object_id
*old_oid
,
679 const struct object_id
*new_oid
,
680 struct strbuf
*base
, struct diff_options
*opt
)
682 struct combine_diff_path phead
, *p
;
683 pathchange_fn_t pathchange_old
= opt
->pathchange
;
686 opt
->pathchange
= emit_diff_first_parent_only
;
687 diff_tree_paths(&phead
, new_oid
, &old_oid
, 1, base
, opt
);
689 for (p
= phead
.next
; p
;) {
690 struct combine_diff_path
*pprev
= p
;
695 opt
->pathchange
= pathchange_old
;
699 int diff_tree_oid(const struct object_id
*old_oid
,
700 const struct object_id
*new_oid
,
701 const char *base_str
, struct diff_options
*opt
)
706 strbuf_init(&base
, PATH_MAX
);
707 strbuf_addstr(&base
, base_str
);
709 retval
= ll_diff_tree_oid(old_oid
, new_oid
, &base
, opt
);
710 if (!*base_str
&& DIFF_OPT_TST(opt
, FOLLOW_RENAMES
) && diff_might_be_rename())
711 try_to_follow_renames(old_oid
, new_oid
, &base
, opt
);
713 strbuf_release(&base
);
718 int diff_root_tree_oid(const struct object_id
*new_oid
, const char *base
, struct diff_options
*opt
)
720 return diff_tree_oid(NULL
, new_oid
, base
, opt
);