3 #include "environment.h"
5 #include "repository.h"
6 #include "sparse-index.h"
10 #include "cache-tree.h"
13 #include "fsmonitor.h"
15 struct modify_index_context
{
16 struct index_state
*write
;
17 struct pattern_list
*pl
;
20 static struct cache_entry
*construct_sparse_dir_entry(
21 struct index_state
*istate
,
22 const char *sparse_dir
,
23 struct cache_tree
*tree
)
25 struct cache_entry
*de
;
27 de
= make_cache_entry(istate
, S_IFDIR
, &tree
->oid
, sparse_dir
, 0, 0);
29 de
->ce_flags
|= CE_SKIP_WORKTREE
;
34 * Returns the number of entries "inserted" into the index.
36 static int convert_to_sparse_rec(struct index_state
*istate
,
39 const char *ct_path
, size_t ct_pathlen
,
40 struct cache_tree
*ct
)
42 int i
, can_convert
= 1;
43 int start_converted
= num_converted
;
44 struct strbuf child_path
= STRBUF_INIT
;
47 * Is the current path outside of the sparse cone?
48 * Then check if the region can be replaced by a sparse
49 * directory entry (everything is sparse and merged).
51 if (path_in_sparse_checkout(ct_path
, istate
))
54 for (i
= start
; can_convert
&& i
< end
; i
++) {
55 struct cache_entry
*ce
= istate
->cache
[i
];
58 S_ISGITLINK(ce
->ce_mode
) ||
59 !(ce
->ce_flags
& CE_SKIP_WORKTREE
))
64 struct cache_entry
*se
;
65 se
= construct_sparse_dir_entry(istate
, ct_path
, ct
);
67 istate
->cache
[num_converted
++] = se
;
71 for (i
= start
; i
< end
; ) {
72 int count
, span
, pos
= -1;
73 const char *base
, *slash
;
74 struct cache_entry
*ce
= istate
->cache
[i
];
77 * Detect if this is a normal entry outside of any subtree
80 base
= ce
->name
+ ct_pathlen
;
81 slash
= strchr(base
, '/');
84 pos
= cache_tree_subtree_pos(ct
, base
, slash
- base
);
87 istate
->cache
[num_converted
++] = ce
;
92 strbuf_setlen(&child_path
, 0);
93 strbuf_add(&child_path
, ce
->name
, slash
- ce
->name
+ 1);
95 span
= ct
->down
[pos
]->cache_tree
->entry_count
;
96 count
= convert_to_sparse_rec(istate
,
97 num_converted
, i
, i
+ span
,
98 child_path
.buf
, child_path
.len
,
99 ct
->down
[pos
]->cache_tree
);
100 num_converted
+= count
;
104 strbuf_release(&child_path
);
105 return num_converted
- start_converted
;
108 int set_sparse_index_config(struct repository
*repo
, int enable
)
110 int res
= repo_config_set_worktree_gently(repo
,
112 enable
? "true" : "false");
113 prepare_repo_settings(repo
);
114 repo
->settings
.sparse_index
= enable
;
118 static int index_has_unmerged_entries(struct index_state
*istate
)
121 for (i
= 0; i
< istate
->cache_nr
; i
++) {
122 if (ce_stage(istate
->cache
[i
]))
129 int is_sparse_index_allowed(struct index_state
*istate
, int flags
)
131 if (!core_apply_sparse_checkout
|| !core_sparse_checkout_cone
)
134 if (!(flags
& SPARSE_INDEX_MEMORY_ONLY
)) {
138 * The sparse index is not (yet) integrated with a split index.
140 if (istate
->split_index
|| git_env_bool("GIT_TEST_SPLIT_INDEX", 0))
143 * The GIT_TEST_SPARSE_INDEX environment variable triggers the
144 * index.sparse config variable to be on.
146 test_env
= git_env_bool("GIT_TEST_SPARSE_INDEX", -1);
148 set_sparse_index_config(istate
->repo
, test_env
);
151 * Only convert to sparse if index.sparse is set.
153 prepare_repo_settings(istate
->repo
);
154 if (!istate
->repo
->settings
.sparse_index
)
158 if (init_sparse_checkout_patterns(istate
))
162 * We need cone-mode patterns to use sparse-index. If a user edits
163 * their sparse-checkout file manually, then we can detect during
164 * parsing that they are not actually using cone-mode patterns and
165 * hence we need to abort this conversion _without error_. Warnings
166 * already exist in the pattern parsing to inform the user of their
169 if (!istate
->sparse_checkout_patterns
->use_cone_patterns
)
175 int convert_to_sparse(struct index_state
*istate
, int flags
)
178 * If the index is already sparse, empty, or otherwise
179 * cannot be converted to sparse, do not convert.
181 if (istate
->sparse_index
== INDEX_COLLAPSED
|| !istate
->cache_nr
||
182 !is_sparse_index_allowed(istate
, flags
))
186 * NEEDSWORK: If we have unmerged entries, then stay full.
187 * Unmerged entries prevent the cache-tree extension from working.
189 if (index_has_unmerged_entries(istate
))
192 if (!cache_tree_fully_valid(istate
->cache_tree
)) {
193 /* Clear and recompute the cache-tree */
194 cache_tree_free(&istate
->cache_tree
);
197 * Silently return if there is a problem with the cache tree update,
198 * which might just be due to a conflict state in some entry.
200 * This might create new tree objects, so be sure to use
201 * WRITE_TREE_MISSING_OK.
203 if (cache_tree_update(istate
, WRITE_TREE_MISSING_OK
))
207 remove_fsmonitor(istate
);
209 trace2_region_enter("index", "convert_to_sparse", istate
->repo
);
210 istate
->cache_nr
= convert_to_sparse_rec(istate
,
211 0, 0, istate
->cache_nr
,
212 "", 0, istate
->cache_tree
);
214 /* Clear and recompute the cache-tree */
215 cache_tree_free(&istate
->cache_tree
);
216 cache_tree_update(istate
, 0);
218 istate
->fsmonitor_has_run_once
= 0;
219 FREE_AND_NULL(istate
->fsmonitor_dirty
);
220 FREE_AND_NULL(istate
->fsmonitor_last_update
);
222 istate
->sparse_index
= INDEX_COLLAPSED
;
223 trace2_region_leave("index", "convert_to_sparse", istate
->repo
);
227 static void set_index_entry(struct index_state
*istate
, int nr
, struct cache_entry
*ce
)
229 ALLOC_GROW(istate
->cache
, nr
+ 1, istate
->cache_alloc
);
231 istate
->cache
[nr
] = ce
;
232 add_name_hash(istate
, ce
);
235 static int add_path_to_index(const struct object_id
*oid
,
236 struct strbuf
*base
, const char *path
,
237 unsigned int mode
, void *context
)
239 struct modify_index_context
*ctx
= (struct modify_index_context
*)context
;
240 struct cache_entry
*ce
;
241 size_t len
= base
->len
;
245 size_t baselen
= base
->len
;
247 return READ_TREE_RECURSIVE
;
250 * Have we expanded to a point outside of the sparse-checkout?
252 * Artificially pad the path name with a slash "/" to
253 * indicate it as a directory, and add an arbitrary file
254 * name ("-") so we can consider base->buf as a file name
255 * to match against the cone-mode patterns.
257 * If we compared just "path", then we would expand more
258 * than we should. Since every file at root is always
259 * included, we would expand every directory at root at
260 * least one level deep instead of using sparse directory
263 strbuf_addstr(base
, path
);
264 strbuf_add(base
, "/-", 2);
266 if (path_matches_pattern_list(base
->buf
, base
->len
,
268 ctx
->pl
, ctx
->write
)) {
269 strbuf_setlen(base
, baselen
);
270 return READ_TREE_RECURSIVE
;
274 * The path "{base}{path}/" is a sparse directory. Create the correct
275 * name for inserting the entry into the index.
277 strbuf_setlen(base
, base
->len
- 1);
279 strbuf_addstr(base
, path
);
282 ce
= make_cache_entry(ctx
->write
, mode
, oid
, base
->buf
, 0, 0);
283 ce
->ce_flags
|= CE_SKIP_WORKTREE
| CE_EXTENDED
;
284 set_index_entry(ctx
->write
, ctx
->write
->cache_nr
++, ce
);
286 strbuf_setlen(base
, len
);
290 void expand_index(struct index_state
*istate
, struct pattern_list
*pl
)
293 struct index_state
*full
;
294 struct strbuf base
= STRBUF_INIT
;
295 const char *tr_region
;
296 struct modify_index_context ctx
;
299 * If the index is already full, then keep it full. We will convert
300 * it to a sparse index on write, if possible.
302 if (istate
->sparse_index
== INDEX_EXPANDED
)
306 * If our index is sparse, but our new pattern set does not use
307 * cone mode patterns, then we need to expand the index before we
308 * continue. A NULL pattern set indicates a full expansion to a
311 if (pl
&& !pl
->use_cone_patterns
) {
315 * We might contract file entries into sparse-directory
316 * entries, and for that we will need the cache tree to
319 cache_tree_free(&istate
->cache_tree
);
322 * If there is a problem creating the cache tree, then we
323 * need to expand to a full index since we cannot satisfy
324 * the current request as a sparse index.
326 if (cache_tree_update(istate
, 0))
331 * A NULL pattern set indicates we are expanding a full index, so
332 * we use a special region name that indicates the full expansion.
333 * This is used by test cases, but also helps to differentiate the
336 tr_region
= pl
? "expand_index" : "ensure_full_index";
337 trace2_region_enter("index", tr_region
, istate
->repo
);
339 /* initialize basics of new index */
340 full
= xcalloc(1, sizeof(struct index_state
));
341 memcpy(full
, istate
, sizeof(struct index_state
));
344 * This slightly-misnamed 'full' index might still be sparse if we
345 * are only modifying the list of sparse directories. This hinges
346 * on whether we have a non-NULL pattern list.
348 full
->sparse_index
= pl
? INDEX_PARTIALLY_SPARSE
: INDEX_EXPANDED
;
350 /* then change the necessary things */
351 full
->cache_alloc
= (3 * istate
->cache_alloc
) / 2;
353 ALLOC_ARRAY(full
->cache
, full
->cache_alloc
);
358 for (i
= 0; i
< istate
->cache_nr
; i
++) {
359 struct cache_entry
*ce
= istate
->cache
[i
];
364 if (!S_ISSPARSEDIR(ce
->ce_mode
)) {
365 set_index_entry(full
, full
->cache_nr
++, ce
);
369 /* We now have a sparse directory entry. Should we expand? */
371 path_matches_pattern_list(ce
->name
, ce
->ce_namelen
,
373 pl
, istate
) == NOT_MATCHED
) {
374 set_index_entry(full
, full
->cache_nr
++, ce
);
378 if (!(ce
->ce_flags
& CE_SKIP_WORKTREE
))
379 warning(_("index entry is a directory, but not sparse (%08x)"),
382 /* recursively walk into cd->name */
383 tree
= lookup_tree(istate
->repo
, &ce
->oid
);
385 memset(&ps
, 0, sizeof(ps
));
390 strbuf_setlen(&base
, 0);
391 strbuf_add(&base
, ce
->name
, strlen(ce
->name
));
393 read_tree_at(istate
->repo
, tree
, &base
, &ps
,
394 add_path_to_index
, &ctx
);
396 /* free directory entries. full entries are re-used */
397 discard_cache_entry(ce
);
400 /* Copy back into original index. */
401 memcpy(&istate
->name_hash
, &full
->name_hash
, sizeof(full
->name_hash
));
402 memcpy(&istate
->dir_hash
, &full
->dir_hash
, sizeof(full
->dir_hash
));
403 istate
->sparse_index
= pl
? INDEX_PARTIALLY_SPARSE
: INDEX_EXPANDED
;
405 istate
->cache
= full
->cache
;
406 istate
->cache_nr
= full
->cache_nr
;
407 istate
->cache_alloc
= full
->cache_alloc
;
408 istate
->fsmonitor_has_run_once
= 0;
409 FREE_AND_NULL(istate
->fsmonitor_dirty
);
410 FREE_AND_NULL(istate
->fsmonitor_last_update
);
412 strbuf_release(&base
);
415 /* Clear and recompute the cache-tree */
416 cache_tree_free(&istate
->cache_tree
);
417 cache_tree_update(istate
, 0);
419 trace2_region_leave("index", tr_region
, istate
->repo
);
422 void ensure_full_index(struct index_state
*istate
)
425 BUG("ensure_full_index() must get an index!");
426 expand_index(istate
, NULL
);
429 void ensure_correct_sparsity(struct index_state
*istate
)
432 * If the index can be sparse, make it sparse. Otherwise,
433 * ensure the index is full.
435 if (is_sparse_index_allowed(istate
, 0))
436 convert_to_sparse(istate
, 0);
438 ensure_full_index(istate
);
441 static int path_found(const char *path
, const char **dirname
, size_t *dir_len
,
449 * If dirname corresponds to a directory that doesn't exist, and this
450 * path starts with dirname, then path can't exist.
452 if (!*dir_found
&& !memcmp(path
, *dirname
, *dir_len
))
456 * If path itself exists, return 1.
458 if (!lstat(path
, &st
))
462 * Otherwise, path does not exist so we'll return 0...but we'll first
463 * determine some info about its parent directory so we can avoid
464 * lstat calls for future cache entries.
466 newdir
= strrchr(path
, '/');
468 return 0; /* Didn't find a parent dir; just return 0 now. */
471 * If path starts with directory (which we already lstat'ed and found),
472 * then no need to lstat parent directory again.
474 if (*dir_found
&& *dirname
&& memcmp(path
, *dirname
, *dir_len
))
477 /* Free previous dirname, and cache path's dirname */
479 *dir_len
= newdir
- path
+ 1;
481 tmp
= xstrndup(path
, *dir_len
);
482 *dir_found
= !lstat(tmp
, &st
);
488 void clear_skip_worktree_from_present_files(struct index_state
*istate
)
490 const char *last_dirname
= NULL
;
495 int path_count
[2] = {0, 0};
498 if (!core_apply_sparse_checkout
||
499 sparse_expect_files_outside_of_patterns
)
502 trace2_region_enter("index", "clear_skip_worktree_from_present_files",
505 for (i
= 0; i
< istate
->cache_nr
; i
++) {
506 struct cache_entry
*ce
= istate
->cache
[i
];
508 if (ce_skip_worktree(ce
)) {
509 path_count
[restarted
]++;
510 if (path_found(ce
->name
, &last_dirname
, &dir_len
, &dir_found
)) {
511 if (S_ISSPARSEDIR(ce
->ce_mode
)) {
513 BUG("ensure-full-index did not fully flatten?");
514 ensure_full_index(istate
);
518 ce
->ce_flags
&= ~CE_SKIP_WORKTREE
;
524 trace2_data_intmax("index", istate
->repo
,
525 "sparse_path_count", path_count
[0]);
527 trace2_data_intmax("index", istate
->repo
,
528 "sparse_path_count_full", path_count
[1]);
529 trace2_region_leave("index", "clear_skip_worktree_from_present_files",
534 * This static global helps avoid infinite recursion between
535 * expand_to_path() and index_file_exists().
537 static int in_expand_to_path
= 0;
539 void expand_to_path(struct index_state
*istate
,
540 const char *path
, size_t pathlen
, int icase
)
542 struct strbuf path_mutable
= STRBUF_INIT
;
545 /* prevent extra recursion */
546 if (in_expand_to_path
)
549 if (!istate
->sparse_index
)
552 in_expand_to_path
= 1;
555 * We only need to actually expand a region if the
556 * following are both true:
558 * 1. 'path' is not already in the index.
559 * 2. Some parent directory of 'path' is a sparse directory.
562 if (index_file_exists(istate
, path
, pathlen
, icase
))
565 strbuf_add(&path_mutable
, path
, pathlen
);
566 strbuf_addch(&path_mutable
, '/');
568 /* Check the name hash for all parent directories */
570 while (substr_len
< pathlen
) {
572 char *replace
= strchr(path_mutable
.buf
+ substr_len
, '/');
577 /* replace the character _after_ the slash */
581 if (index_file_exists(istate
, path_mutable
.buf
,
582 path_mutable
.len
, icase
)) {
584 * We found a parent directory in the name-hash
585 * hashtable, because only sparse directory entries
586 * have a trailing '/' character. Since "path" wasn't
587 * in the index, perhaps it exists within this
588 * sparse-directory. Expand accordingly.
590 ensure_full_index(istate
);
595 substr_len
= replace
- path_mutable
.buf
;
599 strbuf_release(&path_mutable
);
600 in_expand_to_path
= 0;