2 * Copyright (C) the libgit2 contributors. All rights reserved.
4 * This file is part of libgit2, distributed under the GNU GPL v2 with
5 * a Linking Exception. For full terms see the included COPYING file.
7 #ifndef INCLUDE_repository_h__
8 #define INCLUDE_repository_h__
12 #include "git2/common.h"
15 #include "git2/repository.h"
16 #include "git2/object.h"
17 #include "git2/config.h"
24 #include "attrcache.h"
25 #include "submodule.h"
26 #include "diff_driver.h"
28 #define DOT_GIT ".git"
29 #define GIT_DIR DOT_GIT "/"
30 #define GIT_DIR_MODE 0755
31 #define GIT_BARE_DIR_MODE 0777
33 /* Default DOS-compatible 8.3 "short name" for a git repository, "GIT~1" */
34 #define GIT_DIR_SHORTNAME "GIT~1"
36 extern bool git_repository__fsync_gitdir
;
38 /** Cvar cache identifiers */
40 GIT_CONFIGMAP_AUTO_CRLF
= 0, /* core.autocrlf */
41 GIT_CONFIGMAP_EOL
, /* core.eol */
42 GIT_CONFIGMAP_SYMLINKS
, /* core.symlinks */
43 GIT_CONFIGMAP_IGNORECASE
, /* core.ignorecase */
44 GIT_CONFIGMAP_FILEMODE
, /* core.filemode */
45 GIT_CONFIGMAP_IGNORESTAT
, /* core.ignorestat */
46 GIT_CONFIGMAP_TRUSTCTIME
, /* core.trustctime */
47 GIT_CONFIGMAP_ABBREV
, /* core.abbrev */
48 GIT_CONFIGMAP_PRECOMPOSE
, /* core.precomposeunicode */
49 GIT_CONFIGMAP_SAFE_CRLF
, /* core.safecrlf */
50 GIT_CONFIGMAP_LOGALLREFUPDATES
, /* core.logallrefupdates */
51 GIT_CONFIGMAP_PROTECTHFS
, /* core.protectHFS */
52 GIT_CONFIGMAP_PROTECTNTFS
, /* core.protectNTFS */
53 GIT_CONFIGMAP_FSYNCOBJECTFILES
, /* core.fsyncObjectFiles */
54 GIT_CONFIGMAP_CACHE_MAX
58 * Configuration map value enumerations
60 * These are the values that are actually stored in the configmap cache,
61 * instead of their string equivalents. These values are internal and
62 * symbolic; make sure that none of them is set to `-1`, since that is
63 * the unique identifier for "not cached"
66 /* The value hasn't been loaded from the cache yet */
67 GIT_CONFIGMAP_NOT_CACHED
= -1,
69 /* core.safecrlf: false, 'fail', 'warn' */
70 GIT_SAFE_CRLF_FALSE
= 0,
71 GIT_SAFE_CRLF_FAIL
= 1,
72 GIT_SAFE_CRLF_WARN
= 2,
74 /* core.autocrlf: false, true, 'input; */
75 GIT_AUTO_CRLF_FALSE
= 0,
76 GIT_AUTO_CRLF_TRUE
= 1,
77 GIT_AUTO_CRLF_INPUT
= 2,
78 GIT_AUTO_CRLF_DEFAULT
= GIT_AUTO_CRLF_FALSE
,
80 /* core.eol: unset, 'crlf', 'lf', 'native' */
85 GIT_EOL_NATIVE
= GIT_EOL_CRLF
,
87 GIT_EOL_NATIVE
= GIT_EOL_LF
,
89 GIT_EOL_DEFAULT
= GIT_EOL_NATIVE
,
91 /* core.symlinks: bool */
92 GIT_SYMLINKS_DEFAULT
= GIT_CONFIGMAP_TRUE
,
94 GIT_IGNORECASE_DEFAULT
= GIT_CONFIGMAP_FALSE
,
96 GIT_FILEMODE_DEFAULT
= GIT_CONFIGMAP_TRUE
,
98 GIT_IGNORESTAT_DEFAULT
= GIT_CONFIGMAP_FALSE
,
100 GIT_TRUSTCTIME_DEFAULT
= GIT_CONFIGMAP_TRUE
,
102 GIT_ABBREV_DEFAULT
= 7,
103 /* core.precomposeunicode */
104 GIT_PRECOMPOSE_DEFAULT
= GIT_CONFIGMAP_FALSE
,
106 GIT_SAFE_CRLF_DEFAULT
= GIT_CONFIGMAP_FALSE
,
107 /* core.logallrefupdates */
108 GIT_LOGALLREFUPDATES_FALSE
= GIT_CONFIGMAP_FALSE
,
109 GIT_LOGALLREFUPDATES_TRUE
= GIT_CONFIGMAP_TRUE
,
110 GIT_LOGALLREFUPDATES_UNSET
= 2,
111 GIT_LOGALLREFUPDATES_ALWAYS
= 3,
112 GIT_LOGALLREFUPDATES_DEFAULT
= GIT_LOGALLREFUPDATES_UNSET
,
113 /* core.protectHFS */
114 GIT_PROTECTHFS_DEFAULT
= GIT_CONFIGMAP_FALSE
,
115 /* core.protectNTFS */
116 GIT_PROTECTNTFS_DEFAULT
= GIT_CONFIGMAP_TRUE
,
117 /* core.fsyncObjectFiles */
118 GIT_FSYNCOBJECTFILES_DEFAULT
= GIT_CONFIGMAP_FALSE
,
119 } git_configmap_value
;
121 /* internal repository init flags */
123 GIT_REPOSITORY_INIT__HAS_DOTGIT
= (1u << 16),
124 GIT_REPOSITORY_INIT__NATURAL_WD
= (1u << 17),
125 GIT_REPOSITORY_INIT__IS_REINIT
= (1u << 18),
128 /** Internal structure for repository object */
129 struct git_repository
{
136 git_attr_cache
*attrcache
;
137 git_diff_driver_registry
*diff_drivers
;
148 git_array_t(git_buf
) reserved_names
;
151 unsigned is_worktree
:1;
153 unsigned int lru_counter
;
155 git_atomic attr_session_key
;
157 git_configmap_value configmap_cache
[GIT_CONFIGMAP_CACHE_MAX
];
158 git_strmap
*submodule_cache
;
161 GIT_INLINE(git_attr_cache
*) git_repository_attr_cache(git_repository
*repo
)
163 return repo
->attrcache
;
166 int git_repository_head_tree(git_tree
**tree
, git_repository
*repo
);
167 int git_repository_create_head(const char *git_dir
, const char *ref_name
);
170 * Called for each HEAD.
172 * Can return either 0, causing the iteration over HEADs to
173 * continue, or a non-0 value causing the iteration to abort. The
174 * return value is passed back to the caller of
175 * `git_repository_foreach_head`
177 typedef int (*git_repository_foreach_head_cb
)(git_repository
*repo
, const char *path
, void *payload
);
180 /* Skip enumeration of the main repository HEAD */
181 GIT_REPOSITORY_FOREACH_HEAD_SKIP_REPO
= (1u << 0),
182 /* Skip enumeration of worktree HEADs */
183 GIT_REPOSITORY_FOREACH_HEAD_SKIP_WORKTREES
= (1u << 1),
187 * Iterate over repository and all worktree HEADs.
189 * This function will be called for the repository HEAD and for
190 * all HEADS of linked worktrees. For each HEAD, the callback is
191 * executed with the given payload. The return value equals the
192 * return value of the last executed callback function.
194 int git_repository_foreach_head(git_repository
*repo
,
195 git_repository_foreach_head_cb cb
,
196 int flags
, void *payload
);
199 * Weak pointers to repository internals.
201 * The returned pointers do not need to be freed. Do not keep
202 * permanent references to these (i.e. between API calls), since they may
203 * become invalidated if the user replaces a repository internal.
205 int git_repository_config__weakptr(git_config
**out
, git_repository
*repo
);
206 int git_repository_odb__weakptr(git_odb
**out
, git_repository
*repo
);
207 int git_repository_refdb__weakptr(git_refdb
**out
, git_repository
*repo
);
208 int git_repository_index__weakptr(git_index
**out
, git_repository
*repo
);
211 * Configuration map cache
213 * Efficient access to the most used config variables of a repository.
214 * The cache is cleared every time the config backend is replaced.
216 int git_repository__configmap_lookup(int *out
, git_repository
*repo
, git_configmap_item item
);
217 void git_repository__configmap_lookup_cache_clear(git_repository
*repo
);
219 GIT_INLINE(int) git_repository__ensure_not_bare(
220 git_repository
*repo
,
221 const char *operation_name
)
223 if (!git_repository_is_bare(repo
))
227 GIT_ERROR_REPOSITORY
,
228 "cannot %s. This operation is not allowed against bare repositories.",
231 return GIT_EBAREREPO
;
234 int git_repository__set_orig_head(git_repository
*repo
, const git_oid
*orig_head
);
236 int git_repository__cleanup_files(git_repository
*repo
, const char *files
[], size_t files_len
);
238 /* The default "reserved names" for a repository */
239 extern git_buf git_repository__reserved_names_win32
[];
240 extern size_t git_repository__reserved_names_win32_len
;
242 extern git_buf git_repository__reserved_names_posix
[];
243 extern size_t git_repository__reserved_names_posix_len
;
246 * Gets any "reserved names" in the repository. This will return paths
247 * that should not be allowed in the repository (like ".git") to avoid
248 * conflicting with the repository path, or with alternate mechanisms to
249 * the repository path (eg, "GIT~1"). Every attempt will be made to look
250 * up all possible reserved names - if there was a conflict for the shortname
251 * GIT~1, for example, this function will try to look up the alternate
252 * shortname. If that fails, this function returns false, but out and outlen
253 * will still be populated with good defaults.
255 bool git_repository__reserved_names(
256 git_buf
**out
, size_t *outlen
, git_repository
*repo
, bool include_ntfs
);