documentation: add some commas where they are helpful
[git.git] / repository.c
bloba7679ceeaa45ce7a20094f9a29a82987290ad354
1 /*
2 * not really _using_ the compat macros, just make sure the_index
3 * declaration matches the definition in this file.
4 */
5 #define USE_THE_INDEX_VARIABLE
6 #include "git-compat-util.h"
7 #include "abspath.h"
8 #include "repository.h"
9 #include "object-store-ll.h"
10 #include "config.h"
11 #include "object.h"
12 #include "lockfile.h"
13 #include "path.h"
14 #include "read-cache-ll.h"
15 #include "remote.h"
16 #include "setup.h"
17 #include "submodule-config.h"
18 #include "sparse-index.h"
19 #include "trace2.h"
20 #include "promisor-remote.h"
22 /* The main repository */
23 static struct repository the_repo;
24 struct repository *the_repository;
25 struct index_state the_index;
27 void initialize_the_repository(void)
29 the_repository = &the_repo;
31 the_repo.index = &the_index;
32 the_repo.objects = raw_object_store_new();
33 the_repo.remote_state = remote_state_new();
34 the_repo.parsed_objects = parsed_object_pool_new();
36 index_state_init(&the_index, the_repository);
38 repo_set_hash_algo(&the_repo, GIT_HASH_SHA1);
41 static void expand_base_dir(char **out, const char *in,
42 const char *base_dir, const char *def_in)
44 free(*out);
45 if (in)
46 *out = xstrdup(in);
47 else
48 *out = xstrfmt("%s/%s", base_dir, def_in);
51 static void repo_set_commondir(struct repository *repo,
52 const char *commondir)
54 struct strbuf sb = STRBUF_INIT;
56 free(repo->commondir);
58 if (commondir) {
59 repo->different_commondir = 1;
60 repo->commondir = xstrdup(commondir);
61 return;
64 repo->different_commondir = get_common_dir_noenv(&sb, repo->gitdir);
65 repo->commondir = strbuf_detach(&sb, NULL);
68 void repo_set_gitdir(struct repository *repo,
69 const char *root,
70 const struct set_gitdir_args *o)
72 const char *gitfile = read_gitfile(root);
74 * repo->gitdir is saved because the caller could pass "root"
75 * that also points to repo->gitdir. We want to keep it alive
76 * until after xstrdup(root). Then we can free it.
78 char *old_gitdir = repo->gitdir;
80 repo->gitdir = xstrdup(gitfile ? gitfile : root);
81 free(old_gitdir);
83 repo_set_commondir(repo, o->commondir);
85 if (!repo->objects->odb) {
86 CALLOC_ARRAY(repo->objects->odb, 1);
87 repo->objects->odb_tail = &repo->objects->odb->next;
89 expand_base_dir(&repo->objects->odb->path, o->object_dir,
90 repo->commondir, "objects");
92 repo->objects->odb->disable_ref_updates = o->disable_ref_updates;
94 free(repo->objects->alternate_db);
95 repo->objects->alternate_db = xstrdup_or_null(o->alternate_db);
96 expand_base_dir(&repo->graft_file, o->graft_file,
97 repo->commondir, "info/grafts");
98 expand_base_dir(&repo->index_file, o->index_file,
99 repo->gitdir, "index");
102 void repo_set_hash_algo(struct repository *repo, int hash_algo)
104 repo->hash_algo = &hash_algos[hash_algo];
108 * Attempt to resolve and set the provided 'gitdir' for repository 'repo'.
109 * Return 0 upon success and a non-zero value upon failure.
111 static int repo_init_gitdir(struct repository *repo, const char *gitdir)
113 int ret = 0;
114 int error = 0;
115 char *abspath = NULL;
116 const char *resolved_gitdir;
117 struct set_gitdir_args args = { NULL };
119 abspath = real_pathdup(gitdir, 0);
120 if (!abspath) {
121 ret = -1;
122 goto out;
125 /* 'gitdir' must reference the gitdir directly */
126 resolved_gitdir = resolve_gitdir_gently(abspath, &error);
127 if (!resolved_gitdir) {
128 ret = -1;
129 goto out;
132 repo_set_gitdir(repo, resolved_gitdir, &args);
134 out:
135 free(abspath);
136 return ret;
139 void repo_set_worktree(struct repository *repo, const char *path)
141 repo->worktree = real_pathdup(path, 1);
143 trace2_def_repo(repo);
146 static int read_and_verify_repository_format(struct repository_format *format,
147 const char *commondir)
149 int ret = 0;
150 struct strbuf sb = STRBUF_INIT;
152 strbuf_addf(&sb, "%s/config", commondir);
153 read_repository_format(format, sb.buf);
154 strbuf_reset(&sb);
156 if (verify_repository_format(format, &sb) < 0) {
157 warning("%s", sb.buf);
158 ret = -1;
161 strbuf_release(&sb);
162 return ret;
166 * Initialize 'repo' based on the provided 'gitdir'.
167 * Return 0 upon success and a non-zero value upon failure.
169 int repo_init(struct repository *repo,
170 const char *gitdir,
171 const char *worktree)
173 struct repository_format format = REPOSITORY_FORMAT_INIT;
174 memset(repo, 0, sizeof(*repo));
176 repo->objects = raw_object_store_new();
177 repo->parsed_objects = parsed_object_pool_new();
178 repo->remote_state = remote_state_new();
180 if (repo_init_gitdir(repo, gitdir))
181 goto error;
183 if (read_and_verify_repository_format(&format, repo->commondir))
184 goto error;
186 repo_set_hash_algo(repo, format.hash_algo);
187 repo->repository_format_worktree_config = format.worktree_config;
189 /* take ownership of format.partial_clone */
190 repo->repository_format_partial_clone = format.partial_clone;
191 format.partial_clone = NULL;
193 if (worktree)
194 repo_set_worktree(repo, worktree);
196 clear_repository_format(&format);
197 return 0;
199 error:
200 repo_clear(repo);
201 return -1;
204 int repo_submodule_init(struct repository *subrepo,
205 struct repository *superproject,
206 const char *path,
207 const struct object_id *treeish_name)
209 struct strbuf gitdir = STRBUF_INIT;
210 struct strbuf worktree = STRBUF_INIT;
211 int ret = 0;
213 strbuf_repo_worktree_path(&gitdir, superproject, "%s/.git", path);
214 strbuf_repo_worktree_path(&worktree, superproject, "%s", path);
216 if (repo_init(subrepo, gitdir.buf, worktree.buf)) {
218 * If initialization fails then it may be due to the submodule
219 * not being populated in the superproject's worktree. Instead
220 * we can try to initialize the submodule by finding it's gitdir
221 * in the superproject's 'modules' directory. In this case the
222 * submodule would not have a worktree.
224 const struct submodule *sub =
225 submodule_from_path(superproject, treeish_name, path);
226 if (!sub) {
227 ret = -1;
228 goto out;
231 strbuf_reset(&gitdir);
232 submodule_name_to_gitdir(&gitdir, superproject, sub->name);
234 if (repo_init(subrepo, gitdir.buf, NULL)) {
235 ret = -1;
236 goto out;
240 subrepo->submodule_prefix = xstrfmt("%s%s/",
241 superproject->submodule_prefix ?
242 superproject->submodule_prefix :
243 "", path);
245 out:
246 strbuf_release(&gitdir);
247 strbuf_release(&worktree);
248 return ret;
251 static void repo_clear_path_cache(struct repo_path_cache *cache)
253 FREE_AND_NULL(cache->squash_msg);
254 FREE_AND_NULL(cache->squash_msg);
255 FREE_AND_NULL(cache->merge_msg);
256 FREE_AND_NULL(cache->merge_rr);
257 FREE_AND_NULL(cache->merge_mode);
258 FREE_AND_NULL(cache->merge_head);
259 FREE_AND_NULL(cache->merge_autostash);
260 FREE_AND_NULL(cache->auto_merge);
261 FREE_AND_NULL(cache->fetch_head);
262 FREE_AND_NULL(cache->shallow);
265 void repo_clear(struct repository *repo)
267 FREE_AND_NULL(repo->gitdir);
268 FREE_AND_NULL(repo->commondir);
269 FREE_AND_NULL(repo->graft_file);
270 FREE_AND_NULL(repo->index_file);
271 FREE_AND_NULL(repo->worktree);
272 FREE_AND_NULL(repo->submodule_prefix);
274 raw_object_store_clear(repo->objects);
275 FREE_AND_NULL(repo->objects);
277 parsed_object_pool_clear(repo->parsed_objects);
278 FREE_AND_NULL(repo->parsed_objects);
280 if (repo->config) {
281 git_configset_clear(repo->config);
282 FREE_AND_NULL(repo->config);
285 if (repo->submodule_cache) {
286 submodule_cache_free(repo->submodule_cache);
287 repo->submodule_cache = NULL;
290 if (repo->index) {
291 discard_index(repo->index);
292 if (repo->index != &the_index)
293 FREE_AND_NULL(repo->index);
296 if (repo->promisor_remote_config) {
297 promisor_remote_clear(repo->promisor_remote_config);
298 FREE_AND_NULL(repo->promisor_remote_config);
301 if (repo->remote_state) {
302 remote_state_clear(repo->remote_state);
303 FREE_AND_NULL(repo->remote_state);
306 repo_clear_path_cache(&repo->cached_paths);
309 int repo_read_index(struct repository *repo)
311 int res;
313 /* Complete the double-reference */
314 if (!repo->index) {
315 ALLOC_ARRAY(repo->index, 1);
316 index_state_init(repo->index, repo);
317 } else if (repo->index->repo != repo) {
318 BUG("repo's index should point back at itself");
321 res = read_index_from(repo->index, repo->index_file, repo->gitdir);
323 prepare_repo_settings(repo);
324 if (repo->settings.command_requires_full_index)
325 ensure_full_index(repo->index);
328 * If sparse checkouts are in use, check whether paths with the
329 * SKIP_WORKTREE attribute are missing from the worktree; if not,
330 * clear that attribute for that path.
332 clear_skip_worktree_from_present_files(repo->index);
334 return res;
337 int repo_hold_locked_index(struct repository *repo,
338 struct lock_file *lf,
339 int flags)
341 if (!repo->index_file)
342 BUG("the repo hasn't been setup");
343 return hold_lock_file_for_update(lf, repo->index_file, flags);