Line | Count | Source |
1 | | #ifndef SETUP_H |
2 | | #define SETUP_H |
3 | | |
4 | | #include "refs.h" |
5 | | #include "string-list.h" |
6 | | |
7 | | int is_inside_git_dir(void); |
8 | | int is_inside_work_tree(void); |
9 | | int get_common_dir_noenv(struct strbuf *sb, const char *gitdir); |
10 | | int get_common_dir(struct strbuf *sb, const char *gitdir); |
11 | | |
12 | | /* |
13 | | * Return true if the given path is a git directory; note that this _just_ |
14 | | * looks at the directory itself. If you want to know whether "foo/.git" |
15 | | * is a repository, you must feed that path, not just "foo". |
16 | | */ |
17 | | int is_git_directory(const char *path); |
18 | | |
19 | | /* |
20 | | * Return 1 if the given path is the root of a git repository or |
21 | | * submodule, else 0. Will not return 1 for bare repositories with the |
22 | | * exception of creating a bare repository in "foo/.git" and calling |
23 | | * is_git_repository("foo"). |
24 | | * |
25 | | * If we run into read errors, we err on the side of saying "yes, it is", |
26 | | * as we usually consider sub-repos precious, and would prefer to err on the |
27 | | * side of not disrupting or deleting them. |
28 | | */ |
29 | | int is_nonbare_repository_dir(struct strbuf *path); |
30 | | |
31 | 0 | #define READ_GITFILE_ERR_STAT_FAILED 1 |
32 | 0 | #define READ_GITFILE_ERR_NOT_A_FILE 2 |
33 | 0 | #define READ_GITFILE_ERR_OPEN_FAILED 3 |
34 | 0 | #define READ_GITFILE_ERR_READ_FAILED 4 |
35 | 0 | #define READ_GITFILE_ERR_INVALID_FORMAT 5 |
36 | 0 | #define READ_GITFILE_ERR_NO_PATH 6 |
37 | 0 | #define READ_GITFILE_ERR_NOT_A_REPO 7 |
38 | 0 | #define READ_GITFILE_ERR_TOO_LARGE 8 |
39 | | void read_gitfile_error_die(int error_code, const char *path, const char *dir); |
40 | | const char *read_gitfile_gently(const char *path, int *return_error_code); |
41 | 0 | #define read_gitfile(path) read_gitfile_gently((path), NULL) |
42 | | const char *resolve_gitdir_gently(const char *suspect, int *return_error_code); |
43 | | #define resolve_gitdir(path) resolve_gitdir_gently((path), NULL) |
44 | | |
45 | | /* |
46 | | * Check if a repository is safe and die if it is not, by verifying the |
47 | | * ownership of the worktree (if any), the git directory, and the gitfile (if |
48 | | * any). |
49 | | * |
50 | | * Exemptions for known-safe repositories can be added via `safe.directory` |
51 | | * config settings; for non-bare repositories, their worktree needs to be |
52 | | * added, for bare ones their git directory. |
53 | | */ |
54 | | void die_upon_dubious_ownership(const char *gitfile, const char *worktree, |
55 | | const char *gitdir); |
56 | | |
57 | | void setup_work_tree(void); |
58 | | |
59 | | /* |
60 | | * discover_git_directory_reason() is similar to discover_git_directory(), |
61 | | * except it returns an enum value instead. It is important to note that |
62 | | * a zero-valued return here is actually GIT_DIR_NONE, which is different |
63 | | * from discover_git_directory. |
64 | | */ |
65 | | enum discovery_result { |
66 | | GIT_DIR_EXPLICIT = 1, |
67 | | GIT_DIR_DISCOVERED = 2, |
68 | | GIT_DIR_BARE = 3, |
69 | | /* these are errors */ |
70 | | GIT_DIR_HIT_CEILING = -1, |
71 | | GIT_DIR_HIT_MOUNT_POINT = -2, |
72 | | GIT_DIR_INVALID_GITFILE = -3, |
73 | | GIT_DIR_INVALID_OWNERSHIP = -4, |
74 | | GIT_DIR_DISALLOWED_BARE = -5, |
75 | | GIT_DIR_INVALID_FORMAT = -6, |
76 | | GIT_DIR_CWD_FAILURE = -7, |
77 | | }; |
78 | | enum discovery_result discover_git_directory_reason(struct strbuf *commondir, |
79 | | struct strbuf *gitdir); |
80 | | |
81 | | /* |
82 | | * Find the commondir and gitdir of the repository that contains the current |
83 | | * working directory, without changing the working directory or other global |
84 | | * state. The result is appended to commondir and gitdir. If the discovered |
85 | | * gitdir does not correspond to a worktree, then 'commondir' and 'gitdir' will |
86 | | * both have the same result appended to the buffer. The return value is |
87 | | * either 0 upon success and -1 if no repository was found. |
88 | | */ |
89 | | static inline int discover_git_directory(struct strbuf *commondir, |
90 | | struct strbuf *gitdir) |
91 | 0 | { |
92 | 0 | if (discover_git_directory_reason(commondir, gitdir) <= 0) |
93 | 0 | return -1; |
94 | 0 | return 0; |
95 | 0 | } Unexecuted instantiation: symlinks.c:discover_git_directory Unexecuted instantiation: config.c:discover_git_directory Unexecuted instantiation: dir.c:discover_git_directory Unexecuted instantiation: environment.c:discover_git_directory Unexecuted instantiation: mailmap.c:discover_git_directory Unexecuted instantiation: object-file.c:discover_git_directory Unexecuted instantiation: object-name.c:discover_git_directory Unexecuted instantiation: odb.c:discover_git_directory Unexecuted instantiation: path.c:discover_git_directory Unexecuted instantiation: pathspec.c:discover_git_directory Unexecuted instantiation: refs.c:discover_git_directory Unexecuted instantiation: files-backend.c:discover_git_directory Unexecuted instantiation: reftable-backend.c:discover_git_directory Unexecuted instantiation: remote.c:discover_git_directory Unexecuted instantiation: repo-settings.c:discover_git_directory Unexecuted instantiation: repository.c:discover_git_directory Unexecuted instantiation: revision.c:discover_git_directory Unexecuted instantiation: setup.c:discover_git_directory Unexecuted instantiation: submodule.c:discover_git_directory Unexecuted instantiation: trace.c:discover_git_directory Unexecuted instantiation: worktree.c:discover_git_directory Unexecuted instantiation: wt-status.c:discover_git_directory Unexecuted instantiation: attr.c:discover_git_directory Unexecuted instantiation: commit.c:discover_git_directory Unexecuted instantiation: diff.c:discover_git_directory Unexecuted instantiation: hook.c:discover_git_directory Unexecuted instantiation: line-log.c:discover_git_directory Unexecuted instantiation: parse-options-cb.c:discover_git_directory Unexecuted instantiation: unpack-trees.c:discover_git_directory Unexecuted instantiation: apply.c:discover_git_directory |
96 | | |
97 | | void set_git_work_tree(const char *tree); |
98 | | |
99 | | /* Flags that can be passed to `enter_repo()`. */ |
100 | | enum { |
101 | | /* |
102 | | * Callers that require exact paths (as opposed to allowing known |
103 | | * suffixes like ".git", ".git/.git" to be omitted) can set this bit. |
104 | | */ |
105 | | ENTER_REPO_STRICT = (1<<0), |
106 | | |
107 | | /* |
108 | | * Callers that are willing to run without ownership check can set this |
109 | | * bit. |
110 | | */ |
111 | | ENTER_REPO_ANY_OWNER_OK = (1<<1), |
112 | | }; |
113 | | |
114 | | /* |
115 | | * Discover and enter a repository. |
116 | | * |
117 | | * First, one directory to try is determined by the following algorithm. |
118 | | * |
119 | | * (0) If "strict" is given, the path is used as given and no DWIM is |
120 | | * done. Otherwise: |
121 | | * (1) "~/path" to mean path under the running user's home directory; |
122 | | * (2) "~user/path" to mean path under named user's home directory; |
123 | | * (3) "relative/path" to mean cwd relative directory; or |
124 | | * (4) "/absolute/path" to mean absolute directory. |
125 | | * |
126 | | * Unless "strict" is given, we check "%s/.git", "%s", "%s.git/.git", "%s.git" |
127 | | * in this order. We select the first one that is a valid git repository, and |
128 | | * chdir() to it. If none match, or we fail to chdir, we return NULL. |
129 | | * |
130 | | * If all goes well, we return the directory we used to chdir() (but |
131 | | * before ~user is expanded), avoiding getcwd() resolving symbolic |
132 | | * links. User relative paths are also returned as they are given, |
133 | | * except DWIM suffixing. |
134 | | */ |
135 | | const char *enter_repo(const char *path, unsigned flags); |
136 | | |
137 | | const char *setup_git_directory_gently(int *); |
138 | | const char *setup_git_directory(void); |
139 | | char *prefix_path(const char *prefix, int len, const char *path); |
140 | | char *prefix_path_gently(const char *prefix, int len, int *remaining, const char *path); |
141 | | |
142 | | int check_filename(const char *prefix, const char *name); |
143 | | void verify_filename(const char *prefix, |
144 | | const char *name, |
145 | | int diagnose_misspelt_rev); |
146 | | void verify_non_filename(const char *prefix, const char *name); |
147 | | int path_inside_repo(const char *prefix, const char *path); |
148 | | |
149 | | void sanitize_stdfds(void); |
150 | | int daemonize(void); |
151 | | |
152 | | /* |
153 | | * GIT_REPO_VERSION is the version we write by default. The |
154 | | * _READ variant is the highest number we know how to |
155 | | * handle. |
156 | | */ |
157 | 0 | #define GIT_REPO_VERSION 0 |
158 | 0 | #define GIT_REPO_VERSION_READ 1 |
159 | | |
160 | | /* |
161 | | * You _have_ to initialize a `struct repository_format` using |
162 | | * `= REPOSITORY_FORMAT_INIT` before calling `read_repository_format()`. |
163 | | */ |
164 | | struct repository_format { |
165 | | int version; |
166 | | int precious_objects; |
167 | | char *partial_clone; /* value of extensions.partialclone */ |
168 | | int worktree_config; |
169 | | int relative_worktrees; |
170 | | int is_bare; |
171 | | int hash_algo; |
172 | | int compat_hash_algo; |
173 | | enum ref_storage_format ref_storage_format; |
174 | | int sparse_index; |
175 | | char *work_tree; |
176 | | struct string_list unknown_extensions; |
177 | | struct string_list v1_only_extensions; |
178 | | }; |
179 | | |
180 | | /* |
181 | | * Always use this to initialize a `struct repository_format` |
182 | | * to a well-defined, default state before calling |
183 | | * `read_repository()`. |
184 | | */ |
185 | 0 | #define REPOSITORY_FORMAT_INIT \ |
186 | 0 | { \ |
187 | 0 | .version = -1, \ |
188 | 0 | .is_bare = -1, \ |
189 | 0 | .hash_algo = GIT_HASH_DEFAULT, \ |
190 | 0 | .ref_storage_format = REF_STORAGE_FORMAT_FILES, \ |
191 | 0 | .unknown_extensions = STRING_LIST_INIT_DUP, \ |
192 | 0 | .v1_only_extensions = STRING_LIST_INIT_DUP, \ |
193 | 0 | } |
194 | | |
195 | | /* |
196 | | * Read the repository format characteristics from the config file "path" into |
197 | | * "format" struct. Returns the numeric version. On error, or if no version is |
198 | | * found in the configuration, -1 is returned, format->version is set to -1, |
199 | | * and all other fields in the struct are set to the default configuration |
200 | | * (REPOSITORY_FORMAT_INIT). Always initialize the struct using |
201 | | * REPOSITORY_FORMAT_INIT before calling this function. |
202 | | */ |
203 | | int read_repository_format(struct repository_format *format, const char *path); |
204 | | |
205 | | /* |
206 | | * Free the memory held onto by `format`, but not the struct itself. |
207 | | * (No need to use this after `read_repository_format()` fails.) |
208 | | */ |
209 | | void clear_repository_format(struct repository_format *format); |
210 | | |
211 | | /* |
212 | | * Verify that the repository described by repository_format is something we |
213 | | * can read. If it is, return 0. Otherwise, return -1, and "err" will describe |
214 | | * any errors encountered. |
215 | | */ |
216 | | int verify_repository_format(const struct repository_format *format, |
217 | | struct strbuf *err); |
218 | | |
219 | | /* |
220 | | * Check the repository format version in the path found in repo_get_git_dir(the_repository), |
221 | | * and die if it is a version we don't understand. Generally one would |
222 | | * set_git_dir() before calling this, and use it only for "are we in a valid |
223 | | * repo?". |
224 | | * |
225 | | * If successful and fmt is not NULL, fill fmt with data. |
226 | | */ |
227 | | void check_repository_format(struct repository_format *fmt); |
228 | | |
229 | | const char *get_template_dir(const char *option_template); |
230 | | |
231 | 0 | #define INIT_DB_QUIET (1 << 0) |
232 | 0 | #define INIT_DB_EXIST_OK (1 << 1) |
233 | 0 | #define INIT_DB_SKIP_REFDB (1 << 2) |
234 | | |
235 | | int init_db(const char *git_dir, const char *real_git_dir, |
236 | | const char *template_dir, int hash_algo, |
237 | | enum ref_storage_format ref_storage_format, |
238 | | const char *initial_branch, int init_shared_repository, |
239 | | unsigned int flags); |
240 | | void initialize_repository_version(int hash_algo, |
241 | | enum ref_storage_format ref_storage_format, |
242 | | int reinit); |
243 | | void create_reference_database(enum ref_storage_format ref_storage_format, |
244 | | const char *initial_branch, int quiet); |
245 | | |
246 | | /* |
247 | | * NOTE NOTE NOTE!! |
248 | | * |
249 | | * PERM_UMASK, OLD_PERM_GROUP and OLD_PERM_EVERYBODY enumerations must |
250 | | * not be changed. Old repositories have core.sharedrepository written in |
251 | | * numeric format, and therefore these values are preserved for compatibility |
252 | | * reasons. |
253 | | */ |
254 | | enum sharedrepo { |
255 | | PERM_UMASK = 0, |
256 | | OLD_PERM_GROUP = 1, |
257 | | OLD_PERM_EVERYBODY = 2, |
258 | | PERM_GROUP = 0660, |
259 | | PERM_EVERYBODY = 0664 |
260 | | }; |
261 | | int git_config_perm(const char *var, const char *value); |
262 | | |
263 | | struct startup_info { |
264 | | int have_repository; |
265 | | const char *prefix; |
266 | | const char *original_cwd; |
267 | | }; |
268 | | extern struct startup_info *startup_info; |
269 | | extern const char *tmp_original_cwd; |
270 | | |
271 | | #endif /* SETUP_H */ |