4 static int inside_git_dir
= -1;
5 static int inside_work_tree
= -1;
7 static char *prefix_path_gently(const char *prefix
, int len
, const char *path
)
9 const char *orig
= path
;
11 if (is_absolute_path(orig
)) {
12 const char *temp
= real_path(path
);
13 sanitized
= xmalloc(len
+ strlen(temp
) + 1);
14 strcpy(sanitized
, temp
);
16 sanitized
= xmalloc(len
+ strlen(path
) + 1);
18 memcpy(sanitized
, prefix
, len
);
19 strcpy(sanitized
+ len
, path
);
21 if (normalize_path_copy(sanitized
, sanitized
))
23 if (is_absolute_path(orig
)) {
24 size_t root_len
, len
, total
;
25 const char *work_tree
= get_git_work_tree();
28 len
= strlen(work_tree
);
29 root_len
= offset_1st_component(work_tree
);
30 total
= strlen(sanitized
) + 1;
31 if (strncmp(sanitized
, work_tree
, len
) ||
32 (len
> root_len
&& sanitized
[len
] != '\0' && sanitized
[len
] != '/')) {
37 if (sanitized
[len
] == '/')
39 memmove(sanitized
, sanitized
+ len
, total
- len
);
44 char *prefix_path(const char *prefix
, int len
, const char *path
)
46 char *r
= prefix_path_gently(prefix
, len
, path
);
48 die("'%s' is outside repository", path
);
52 int path_inside_repo(const char *prefix
, const char *path
)
54 int len
= prefix
? strlen(prefix
) : 0;
55 char *r
= prefix_path_gently(prefix
, len
, path
);
63 int check_filename(const char *prefix
, const char *arg
)
68 name
= prefix
? prefix_filename(prefix
, strlen(prefix
), arg
) : arg
;
69 if (!lstat(name
, &st
))
70 return 1; /* file exists */
71 if (errno
== ENOENT
|| errno
== ENOTDIR
)
72 return 0; /* file does not exist */
73 die_errno("failed to stat '%s'", arg
);
76 static void NORETURN
die_verify_filename(const char *prefix
,
78 int diagnose_misspelt_rev
)
80 unsigned char sha1
[20];
83 if (!diagnose_misspelt_rev
)
84 die("%s: no such path in the working tree.\n"
85 "Use 'git <command> -- <path>...' to specify paths that do not exist locally.",
88 * Saying "'(icase)foo' does not exist in the index" when the
89 * user gave us ":(icase)foo" is just stupid. A magic pathspec
90 * begins with a colon and is followed by a non-alnum; do not
91 * let get_sha1_with_mode_1(only_to_die=1) to even trigger.
93 if (!(arg
[0] == ':' && !isalnum(arg
[1])))
94 /* try a detailed diagnostic ... */
95 get_sha1_with_mode_1(arg
, sha1
, &mode
, 1, prefix
);
97 /* ... or fall back the most general message. */
98 die("ambiguous argument '%s': unknown revision or path not in the working tree.\n"
99 "Use '--' to separate paths from revisions, like this:\n"
100 "'git <command> [<revision>...] -- [<file>...]'", arg
);
105 * Verify a filename that we got as an argument for a pathspec
106 * entry. Note that a filename that begins with "-" never verifies
107 * as true, because even if such a filename were to exist, we want
108 * it to be preceded by the "--" marker (or we want the user to
109 * use a format like "./-filename")
111 * The "diagnose_misspelt_rev" is used to provide a user-friendly
112 * diagnosis when dying upon finding that "name" is not a pathname.
113 * If set to 1, the diagnosis will try to diagnose "name" as an
114 * invalid object name (e.g. HEAD:foo). If set to 0, the diagnosis
115 * will only complain about an inexisting file.
117 * This function is typically called to check that a "file or rev"
118 * argument is unambiguous. In this case, the caller will want
119 * diagnose_misspelt_rev == 1 when verifying the first non-rev
120 * argument (which could have been a revision), and
121 * diagnose_misspelt_rev == 0 for the next ones (because we already
122 * saw a filename, there's not ambiguity anymore).
124 void verify_filename(const char *prefix
,
126 int diagnose_misspelt_rev
)
129 die("bad flag '%s' used after filename", arg
);
130 if (check_filename(prefix
, arg
))
132 die_verify_filename(prefix
, arg
, diagnose_misspelt_rev
);
136 * Opposite of the above: the command line did not have -- marker
137 * and we parsed the arg as a refname. It should not be interpretable
140 void verify_non_filename(const char *prefix
, const char *arg
)
142 if (!is_inside_work_tree() || is_inside_git_dir())
146 if (!check_filename(prefix
, arg
))
148 die("ambiguous argument '%s': both revision and filename\n"
149 "Use '--' to separate paths from revisions, like this:\n"
150 "'git <command> [<revision>...] -- [<file>...]'", arg
);
156 * NEEDSWORK: These need to be moved to dir.h or even to a new
157 * pathspec.h when we restructure get_pathspec() users to use the
158 * "struct pathspec" interface.
160 * Possible future magic semantics include stuff like:
162 * { PATHSPEC_NOGLOB, '!', "noglob" },
163 * { PATHSPEC_ICASE, '\0', "icase" },
164 * { PATHSPEC_RECURSIVE, '*', "recursive" },
165 * { PATHSPEC_REGEXP, '\0', "regexp" },
168 #define PATHSPEC_FROMTOP (1<<0)
170 static struct pathspec_magic
{
172 char mnemonic
; /* this cannot be ':'! */
174 } pathspec_magic
[] = {
175 { PATHSPEC_FROMTOP
, '/', "top" },
179 * Take an element of a pathspec and check for magic signatures.
180 * Append the result to the prefix.
182 * For now, we only parse the syntax and throw out anything other than
185 * NEEDSWORK: This needs to be rewritten when we start migrating
186 * get_pathspec() users to use the "struct pathspec" interface. For
187 * example, a pathspec element may be marked as case-insensitive, but
188 * the prefix part must always match literally, and a single stupid
189 * string cannot express such a case.
191 static const char *prefix_pathspec(const char *prefix
, int prefixlen
, const char *elt
)
194 const char *copyfrom
= elt
;
198 ; /* nothing to do */
199 } else if (elt
[1] == '(') {
202 for (copyfrom
= elt
+ 2;
203 *copyfrom
&& *copyfrom
!= ')';
205 size_t len
= strcspn(copyfrom
, ",)");
206 if (copyfrom
[len
] == ')')
207 nextat
= copyfrom
+ len
;
209 nextat
= copyfrom
+ len
+ 1;
212 for (i
= 0; i
< ARRAY_SIZE(pathspec_magic
); i
++)
213 if (strlen(pathspec_magic
[i
].name
) == len
&&
214 !strncmp(pathspec_magic
[i
].name
, copyfrom
, len
)) {
215 magic
|= pathspec_magic
[i
].bit
;
218 if (ARRAY_SIZE(pathspec_magic
) <= i
)
219 die("Invalid pathspec magic '%.*s' in '%s'",
220 (int) len
, copyfrom
, elt
);
222 if (*copyfrom
== ')')
226 for (copyfrom
= elt
+ 1;
227 *copyfrom
&& *copyfrom
!= ':';
231 if (!is_pathspec_magic(ch
))
233 for (i
= 0; i
< ARRAY_SIZE(pathspec_magic
); i
++)
234 if (pathspec_magic
[i
].mnemonic
== ch
) {
235 magic
|= pathspec_magic
[i
].bit
;
238 if (ARRAY_SIZE(pathspec_magic
) <= i
)
239 die("Unimplemented pathspec magic '%c' in '%s'",
242 if (*copyfrom
== ':')
246 if (magic
& PATHSPEC_FROMTOP
)
247 return xstrdup(copyfrom
);
249 return prefix_path(prefix
, prefixlen
, copyfrom
);
253 * N.B. get_pathspec() is deprecated in favor of the "struct pathspec"
254 * based interface - see pathspec_magic above.
257 * - prefix - a path relative to the root of the working tree
258 * - pathspec - a list of paths underneath the prefix path
260 * Iterates over pathspec, prepending each path with prefix,
261 * and return the resulting list.
263 * If pathspec is empty, return a singleton list containing prefix.
265 * If pathspec and prefix are both empty, return an empty list.
267 * This is typically used by built-in commands such as add.c, in order
268 * to normalize argv arguments provided to the built-in into a list of
269 * paths to process, all relative to the root of the working tree.
271 const char **get_pathspec(const char *prefix
, const char **pathspec
)
273 const char *entry
= *pathspec
;
274 const char **src
, **dst
;
277 if (!prefix
&& !entry
)
281 static const char *spec
[2];
287 /* Otherwise we have to re-write the entries.. */
290 prefixlen
= prefix
? strlen(prefix
) : 0;
292 *(dst
++) = prefix_pathspec(prefix
, prefixlen
, *src
);
302 * Test if it looks like we're at a git directory.
305 * - either an objects/ directory _or_ the proper
306 * GIT_OBJECT_DIRECTORY environment variable
307 * - a refs/ directory
308 * - either a HEAD symlink or a HEAD file that is formatted as
309 * a proper "ref:", or a regular file HEAD that has a properly
310 * formatted sha1 object name.
312 int is_git_directory(const char *suspect
)
315 size_t len
= strlen(suspect
);
317 if (PATH_MAX
<= len
+ strlen("/objects"))
318 die("Too long path: %.*s", 60, suspect
);
319 strcpy(path
, suspect
);
320 if (getenv(DB_ENVIRONMENT
)) {
321 if (access(getenv(DB_ENVIRONMENT
), X_OK
))
325 strcpy(path
+ len
, "/objects");
326 if (access(path
, X_OK
))
330 strcpy(path
+ len
, "/refs");
331 if (access(path
, X_OK
))
334 strcpy(path
+ len
, "/HEAD");
335 if (validate_headref(path
))
341 int is_inside_git_dir(void)
343 if (inside_git_dir
< 0)
344 inside_git_dir
= is_inside_dir(get_git_dir());
345 return inside_git_dir
;
348 int is_inside_work_tree(void)
350 if (inside_work_tree
< 0)
351 inside_work_tree
= is_inside_dir(get_git_work_tree());
352 return inside_work_tree
;
355 void setup_work_tree(void)
357 const char *work_tree
, *git_dir
;
358 static int initialized
= 0;
362 work_tree
= get_git_work_tree();
363 git_dir
= get_git_dir();
364 if (!is_absolute_path(git_dir
))
365 git_dir
= real_path(get_git_dir());
366 if (!work_tree
|| chdir(work_tree
))
367 die("This operation must be run in a work tree");
370 * Make sure subsequent git processes find correct worktree
371 * if $GIT_WORK_TREE is set relative
373 if (getenv(GIT_WORK_TREE_ENVIRONMENT
))
374 setenv(GIT_WORK_TREE_ENVIRONMENT
, ".", 1);
376 set_git_dir(relative_path(git_dir
, work_tree
));
380 static int check_repository_format_gently(const char *gitdir
, int *nongit_ok
)
382 char repo_config
[PATH_MAX
+1];
385 * git_config() can't be used here because it calls git_pathdup()
386 * to get $GIT_CONFIG/config. That call will make setup_git_env()
387 * set git_dir to ".git".
389 * We are in gitdir setup, no git dir has been found useable yet.
390 * Use a gentler version of git_config() to check if this repo
393 snprintf(repo_config
, PATH_MAX
, "%s/config", gitdir
);
394 git_config_early(check_repository_format_version
, NULL
, repo_config
);
395 if (GIT_REPO_VERSION
< repository_format_version
) {
397 die ("Expected git repo version <= %d, found %d",
398 GIT_REPO_VERSION
, repository_format_version
);
399 warning("Expected git repo version <= %d, found %d",
400 GIT_REPO_VERSION
, repository_format_version
);
401 warning("Please upgrade Git");
409 * Try to read the location of the git directory from the .git file,
410 * return path to git directory if found.
412 const char *read_gitfile(const char *path
)
423 if (!S_ISREG(st
.st_mode
))
425 fd
= open(path
, O_RDONLY
);
427 die_errno("Error opening '%s'", path
);
428 buf
= xmalloc(st
.st_size
+ 1);
429 len
= read_in_full(fd
, buf
, st
.st_size
);
431 if (len
!= st
.st_size
)
432 die("Error reading %s", path
);
434 if (prefixcmp(buf
, "gitdir: "))
435 die("Invalid gitfile format: %s", path
);
436 while (buf
[len
- 1] == '\n' || buf
[len
- 1] == '\r')
439 die("No path in gitfile: %s", path
);
443 if (!is_absolute_path(dir
) && (slash
= strrchr(path
, '/'))) {
444 size_t pathlen
= slash
+1 - path
;
445 size_t dirlen
= pathlen
+ len
- 8;
446 dir
= xmalloc(dirlen
+ 1);
447 strncpy(dir
, path
, pathlen
);
448 strncpy(dir
+ pathlen
, buf
+ 8, len
- 8);
454 if (!is_git_directory(dir
))
455 die("Not a git repository: %s", dir
);
456 path
= real_path(dir
);
462 static const char *setup_explicit_git_dir(const char *gitdirenv
,
466 const char *work_tree_env
= getenv(GIT_WORK_TREE_ENVIRONMENT
);
467 const char *worktree
;
471 if (PATH_MAX
- 40 < strlen(gitdirenv
))
472 die("'$%s' too big", GIT_DIR_ENVIRONMENT
);
474 gitfile
= (char*)read_gitfile(gitdirenv
);
476 gitfile
= xstrdup(gitfile
);
480 if (!is_git_directory(gitdirenv
)) {
486 die("Not a git repository: '%s'", gitdirenv
);
489 if (check_repository_format_gently(gitdirenv
, nongit_ok
)) {
494 /* #3, #7, #11, #15, #19, #23, #27, #31 (see t1510) */
496 set_git_work_tree(work_tree_env
);
497 else if (is_bare_repository_cfg
> 0) {
498 if (git_work_tree_cfg
) /* #22.2, #30 */
499 die("core.bare and core.worktree do not make sense");
502 set_git_dir(gitdirenv
);
506 else if (git_work_tree_cfg
) { /* #6, #14 */
507 if (is_absolute_path(git_work_tree_cfg
))
508 set_git_work_tree(git_work_tree_cfg
);
510 char core_worktree
[PATH_MAX
];
511 if (chdir(gitdirenv
))
512 die_errno("Could not chdir to '%s'", gitdirenv
);
513 if (chdir(git_work_tree_cfg
))
514 die_errno("Could not chdir to '%s'", git_work_tree_cfg
);
515 if (!getcwd(core_worktree
, PATH_MAX
))
516 die_errno("Could not get directory '%s'", git_work_tree_cfg
);
518 die_errno("Could not come back to cwd");
519 set_git_work_tree(core_worktree
);
523 set_git_work_tree(".");
525 /* set_git_work_tree() must have been called by now */
526 worktree
= get_git_work_tree();
528 /* both get_git_work_tree() and cwd are already normalized */
529 if (!strcmp(cwd
, worktree
)) { /* cwd == worktree */
530 set_git_dir(gitdirenv
);
535 offset
= dir_inside_of(cwd
, worktree
);
536 if (offset
>= 0) { /* cwd inside worktree? */
537 set_git_dir(real_path(gitdirenv
));
539 die_errno("Could not chdir to '%s'", worktree
);
546 /* cwd outside worktree */
547 set_git_dir(gitdirenv
);
552 static const char *setup_discovered_git_dir(const char *gitdir
,
553 char *cwd
, int offset
, int len
,
556 if (check_repository_format_gently(gitdir
, nongit_ok
))
559 /* --work-tree is set without --git-dir; use discovered one */
560 if (getenv(GIT_WORK_TREE_ENVIRONMENT
) || git_work_tree_cfg
) {
561 if (offset
!= len
&& !is_absolute_path(gitdir
))
562 gitdir
= xstrdup(real_path(gitdir
));
564 die_errno("Could not come back to cwd");
565 return setup_explicit_git_dir(gitdir
, cwd
, len
, nongit_ok
);
568 /* #16.2, #17.2, #20.2, #21.2, #24, #25, #28, #29 (see t1510) */
569 if (is_bare_repository_cfg
> 0) {
570 set_git_dir(offset
== len
? gitdir
: real_path(gitdir
));
572 die_errno("Could not come back to cwd");
576 /* #0, #1, #5, #8, #9, #12, #13 */
577 set_git_work_tree(".");
578 if (strcmp(gitdir
, DEFAULT_GIT_DIR_ENVIRONMENT
))
581 inside_work_tree
= 1;
585 /* Make "offset" point to past the '/', and add a '/' at the end */
592 /* #16.1, #17.1, #20.1, #21.1, #22.1 (see t1510) */
593 static const char *setup_bare_git_dir(char *cwd
, int offset
, int len
, int *nongit_ok
)
597 if (check_repository_format_gently(".", nongit_ok
))
600 /* --work-tree is set without --git-dir; use discovered one */
601 if (getenv(GIT_WORK_TREE_ENVIRONMENT
) || git_work_tree_cfg
) {
604 gitdir
= offset
== len
? "." : xmemdupz(cwd
, offset
);
606 die_errno("Could not come back to cwd");
607 return setup_explicit_git_dir(gitdir
, cwd
, len
, nongit_ok
);
611 inside_work_tree
= 0;
614 die_errno("Cannot come back to cwd");
615 root_len
= offset_1st_component(cwd
);
616 cwd
[offset
> root_len
? offset
: root_len
] = '\0';
624 static const char *setup_nongit(const char *cwd
, int *nongit_ok
)
627 die("Not a git repository (or any of the parent directories): %s", DEFAULT_GIT_DIR_ENVIRONMENT
);
629 die_errno("Cannot come back to cwd");
634 static dev_t
get_device_or_die(const char *path
, const char *prefix
, int prefix_len
)
637 if (stat(path
, &buf
)) {
638 die_errno("failed to stat '%*s%s%s'",
640 prefix
? prefix
: "",
641 prefix
? "/" : "", path
);
647 * We cannot decide in this function whether we are in the work tree or
648 * not, since the config can only be read _after_ this function was called.
650 static const char *setup_git_directory_gently_1(int *nongit_ok
)
652 const char *env_ceiling_dirs
= getenv(CEILING_DIRECTORIES_ENVIRONMENT
);
653 static char cwd
[PATH_MAX
+1];
654 const char *gitdirenv
, *ret
;
656 int len
, offset
, offset_parent
, ceil_offset
;
657 dev_t current_device
= 0;
658 int one_filesystem
= 1;
661 * Let's assume that we are in a git repository.
662 * If it turns out later that we are somewhere else, the value will be
663 * updated accordingly.
668 if (!getcwd(cwd
, sizeof(cwd
)-1))
669 die_errno("Unable to read current working directory");
670 offset
= len
= strlen(cwd
);
673 * If GIT_DIR is set explicitly, we're not going
674 * to do any discovery, but we still do repository
677 gitdirenv
= getenv(GIT_DIR_ENVIRONMENT
);
679 return setup_explicit_git_dir(gitdirenv
, cwd
, len
, nongit_ok
);
681 ceil_offset
= longest_ancestor_length(cwd
, env_ceiling_dirs
);
682 if (ceil_offset
< 0 && has_dos_drive_prefix(cwd
))
686 * Test in the following order (relative to the cwd):
687 * - .git (file containing "gitdir: <path>")
696 one_filesystem
= !git_env_bool("GIT_DISCOVERY_ACROSS_FILESYSTEM", 0);
698 current_device
= get_device_or_die(".", NULL
, 0);
700 gitfile
= (char*)read_gitfile(DEFAULT_GIT_DIR_ENVIRONMENT
);
702 gitdirenv
= gitfile
= xstrdup(gitfile
);
704 if (is_git_directory(DEFAULT_GIT_DIR_ENVIRONMENT
))
705 gitdirenv
= DEFAULT_GIT_DIR_ENVIRONMENT
;
709 ret
= setup_discovered_git_dir(gitdirenv
,
717 if (is_git_directory("."))
718 return setup_bare_git_dir(cwd
, offset
, len
, nongit_ok
);
720 offset_parent
= offset
;
721 while (--offset_parent
> ceil_offset
&& cwd
[offset_parent
] != '/');
722 if (offset_parent
<= ceil_offset
)
723 return setup_nongit(cwd
, nongit_ok
);
724 if (one_filesystem
) {
725 dev_t parent_device
= get_device_or_die("..", cwd
, offset
);
726 if (parent_device
!= current_device
) {
729 die_errno("Cannot come back to cwd");
734 die("Not a git repository (or any parent up to mount point %s)\n"
735 "Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).", cwd
);
740 die_errno("Cannot change to '%s/..'", cwd
);
742 offset
= offset_parent
;
746 const char *setup_git_directory_gently(int *nongit_ok
)
750 prefix
= setup_git_directory_gently_1(nongit_ok
);
752 setenv("GIT_PREFIX", prefix
, 1);
754 setenv("GIT_PREFIX", "", 1);
757 startup_info
->have_repository
= !nongit_ok
|| !*nongit_ok
;
758 startup_info
->prefix
= prefix
;
763 int git_config_perm(const char *var
, const char *value
)
771 if (!strcmp(value
, "umask"))
773 if (!strcmp(value
, "group"))
775 if (!strcmp(value
, "all") ||
776 !strcmp(value
, "world") ||
777 !strcmp(value
, "everybody"))
778 return PERM_EVERYBODY
;
780 /* Parse octal numbers */
781 i
= strtol(value
, &endptr
, 8);
783 /* If not an octal number, maybe true/false? */
785 return git_config_bool(var
, value
) ? PERM_GROUP
: PERM_UMASK
;
788 * Treat values 0, 1 and 2 as compatibility cases, otherwise it is
789 * a chmod value to restrict to.
792 case PERM_UMASK
: /* 0 */
794 case OLD_PERM_GROUP
: /* 1 */
796 case OLD_PERM_EVERYBODY
: /* 2 */
797 return PERM_EVERYBODY
;
800 /* A filemode value was given: 0xxx */
802 if ((i
& 0600) != 0600)
803 die("Problem with core.sharedRepository filemode value "
804 "(0%.3o).\nThe owner of files must always have "
805 "read and write permissions.", i
);
808 * Mask filemode value. Others can not get write permission.
809 * x flags for directories are handled separately.
814 int check_repository_format_version(const char *var
, const char *value
, void *cb
)
816 if (strcmp(var
, "core.repositoryformatversion") == 0)
817 repository_format_version
= git_config_int(var
, value
);
818 else if (strcmp(var
, "core.sharedrepository") == 0)
819 shared_repository
= git_config_perm(var
, value
);
820 else if (strcmp(var
, "core.bare") == 0) {
821 is_bare_repository_cfg
= git_config_bool(var
, value
);
822 if (is_bare_repository_cfg
== 1)
823 inside_work_tree
= -1;
824 } else if (strcmp(var
, "core.worktree") == 0) {
826 return config_error_nonbool(var
);
827 free(git_work_tree_cfg
);
828 git_work_tree_cfg
= xstrdup(value
);
829 inside_work_tree
= -1;
834 int check_repository_format(void)
836 return check_repository_format_gently(get_git_dir(), NULL
);
840 * Returns the "prefix", a path to the current working directory
841 * relative to the work tree root, or NULL, if the current working
842 * directory is not a strict subdirectory of the work tree root. The
843 * prefix always ends with a '/' character.
845 const char *setup_git_directory(void)
847 return setup_git_directory_gently(NULL
);
850 const char *resolve_gitdir(const char *suspect
)
852 if (is_git_directory(suspect
))
854 return read_gitfile(suspect
);