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
);
169 typedef int (*git_repository_foreach_worktree_cb
)(git_repository
*, void *);
171 int git_repository_foreach_worktree(git_repository
*repo
,
172 git_repository_foreach_worktree_cb cb
,
176 * Weak pointers to repository internals.
178 * The returned pointers do not need to be freed. Do not keep
179 * permanent references to these (i.e. between API calls), since they may
180 * become invalidated if the user replaces a repository internal.
182 int git_repository_config__weakptr(git_config
**out
, git_repository
*repo
);
183 int git_repository_odb__weakptr(git_odb
**out
, git_repository
*repo
);
184 int git_repository_refdb__weakptr(git_refdb
**out
, git_repository
*repo
);
185 int git_repository_index__weakptr(git_index
**out
, git_repository
*repo
);
188 * Configuration map cache
190 * Efficient access to the most used config variables of a repository.
191 * The cache is cleared every time the config backend is replaced.
193 int git_repository__configmap_lookup(int *out
, git_repository
*repo
, git_configmap_item item
);
194 void git_repository__configmap_lookup_cache_clear(git_repository
*repo
);
196 GIT_INLINE(int) git_repository__ensure_not_bare(
197 git_repository
*repo
,
198 const char *operation_name
)
200 if (!git_repository_is_bare(repo
))
204 GIT_ERROR_REPOSITORY
,
205 "cannot %s. This operation is not allowed against bare repositories.",
208 return GIT_EBAREREPO
;
211 int git_repository__set_orig_head(git_repository
*repo
, const git_oid
*orig_head
);
213 int git_repository__cleanup_files(git_repository
*repo
, const char *files
[], size_t files_len
);
215 /* The default "reserved names" for a repository */
216 extern git_buf git_repository__reserved_names_win32
[];
217 extern size_t git_repository__reserved_names_win32_len
;
219 extern git_buf git_repository__reserved_names_posix
[];
220 extern size_t git_repository__reserved_names_posix_len
;
223 * Gets any "reserved names" in the repository. This will return paths
224 * that should not be allowed in the repository (like ".git") to avoid
225 * conflicting with the repository path, or with alternate mechanisms to
226 * the repository path (eg, "GIT~1"). Every attempt will be made to look
227 * up all possible reserved names - if there was a conflict for the shortname
228 * GIT~1, for example, this function will try to look up the alternate
229 * shortname. If that fails, this function returns false, but out and outlen
230 * will still be populated with good defaults.
232 bool git_repository__reserved_names(
233 git_buf
**out
, size_t *outlen
, git_repository
*repo
, bool include_ntfs
);
236 * The default branch for the repository; the `init.defaultBranch`
237 * configuration option, if set, or `master` if it is not.
239 int git_repository_initialbranch(git_buf
*out
, git_repository
*repo
);