Andrew's git - gitweb.git/blob

   1#include "cache.h"
   2#include "dir.h"
   3
   4static int inside_git_dir = -1;
   5static int inside_work_tree = -1;
   6
   7char *prefix_path(const char *prefix, int len, const char *path)
   8{
   9        const char *orig = path;
  10        char *sanitized;
  11        if (is_absolute_path(orig)) {
  12                const char *temp = make_absolute_path(path);
  13                sanitized = xmalloc(len + strlen(temp) + 1);
  14                strcpy(sanitized, temp);
  15        } else {
  16                sanitized = xmalloc(len + strlen(path) + 1);
  17                if (len)
  18                        memcpy(sanitized, prefix, len);
  19                strcpy(sanitized + len, path);
  20        }
  21        if (normalize_path_copy(sanitized, sanitized))
  22                goto error_out;
  23        if (is_absolute_path(orig)) {
  24                size_t root_len, len, total;
  25                const char *work_tree = get_git_work_tree();
  26                if (!work_tree)
  27                        goto error_out;
  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] != '/')) {
  33                error_out:
  34                        die("'%s' is outside repository", orig);
  35                }
  36                if (sanitized[len] == '/')
  37                        len++;
  38                memmove(sanitized, sanitized + len, total - len);
  39        }
  40        return sanitized;
  41}
  42
  43/*
  44 * Unlike prefix_path, this should be used if the named file does
  45 * not have to interact with index entry; i.e. name of a random file
  46 * on the filesystem.
  47 */
  48const char *prefix_filename(const char *pfx, int pfx_len, const char *arg)
  49{
  50        static char path[PATH_MAX];
  51#ifndef WIN32
  52        if (!pfx_len || is_absolute_path(arg))
  53                return arg;
  54        memcpy(path, pfx, pfx_len);
  55        strcpy(path + pfx_len, arg);
  56#else
  57        char *p;
  58        /* don't add prefix to absolute paths, but still replace '\' by '/' */
  59        if (is_absolute_path(arg))
  60                pfx_len = 0;
  61        else if (pfx_len)
  62                memcpy(path, pfx, pfx_len);
  63        strcpy(path + pfx_len, arg);
  64        for (p = path + pfx_len; *p; p++)
  65                if (*p == '\\')
  66                        *p = '/';
  67#endif
  68        return path;
  69}
  70
  71int check_filename(const char *prefix, const char *arg)
  72{
  73        const char *name;
  74        struct stat st;
  75
  76        name = prefix ? prefix_filename(prefix, strlen(prefix), arg) : arg;
  77        if (!lstat(name, &st))
  78                return 1; /* file exists */
  79        if (errno == ENOENT || errno == ENOTDIR)
  80                return 0; /* file does not exist */
  81        die_errno("failed to stat '%s'", arg);
  82}
  83
  84static void NORETURN die_verify_filename(const char *prefix, const char *arg)
  85{
  86        unsigned char sha1[20];
  87        unsigned mode;
  88        /* try a detailed diagnostic ... */
  89        get_sha1_with_mode_1(arg, sha1, &mode, 0, prefix);
  90        /* ... or fall back the most general message. */
  91        die("ambiguous argument '%s': unknown revision or path not in the working tree.\n"
  92            "Use '--' to separate paths from revisions", arg);
  93
  94}
  95
  96/*
  97 * Verify a filename that we got as an argument for a pathspec
  98 * entry. Note that a filename that begins with "-" never verifies
  99 * as true, because even if such a filename were to exist, we want
 100 * it to be preceded by the "--" marker (or we want the user to
 101 * use a format like "./-filename")
 102 */
 103void verify_filename(const char *prefix, const char *arg)
 104{
 105        if (*arg == '-')
 106                die("bad flag '%s' used after filename", arg);
 107        if (check_filename(prefix, arg))
 108                return;
 109        die_verify_filename(prefix, arg);
 110}
 111
 112/*
 113 * Opposite of the above: the command line did not have -- marker
 114 * and we parsed the arg as a refname.  It should not be interpretable
 115 * as a filename.
 116 */
 117void verify_non_filename(const char *prefix, const char *arg)
 118{
 119        if (!is_inside_work_tree() || is_inside_git_dir())
 120                return;
 121        if (*arg == '-')
 122                return; /* flag */
 123        if (!check_filename(prefix, arg))
 124                return;
 125        die("ambiguous argument '%s': both revision and filename\n"
 126            "Use '--' to separate filenames from revisions", arg);
 127}
 128
 129const char **get_pathspec(const char *prefix, const char **pathspec)
 130{
 131        const char *entry = *pathspec;
 132        const char **src, **dst;
 133        int prefixlen;
 134
 135        if (!prefix && !entry)
 136                return NULL;
 137
 138        if (!entry) {
 139                static const char *spec[2];
 140                spec[0] = prefix;
 141                spec[1] = NULL;
 142                return spec;
 143        }
 144
 145        /* Otherwise we have to re-write the entries.. */
 146        src = pathspec;
 147        dst = pathspec;
 148        prefixlen = prefix ? strlen(prefix) : 0;
 149        while (*src) {
 150                const char *p = prefix_path(prefix, prefixlen, *src);
 151                *(dst++) = p;
 152                src++;
 153        }
 154        *dst = NULL;
 155        if (!*pathspec)
 156                return NULL;
 157        return pathspec;
 158}
 159
 160/*
 161 * Test if it looks like we're at a git directory.
 162 * We want to see:
 163 *
 164 *  - either an objects/ directory _or_ the proper
 165 *    GIT_OBJECT_DIRECTORY environment variable
 166 *  - a refs/ directory
 167 *  - either a HEAD symlink or a HEAD file that is formatted as
 168 *    a proper "ref:", or a regular file HEAD that has a properly
 169 *    formatted sha1 object name.
 170 */
 171static int is_git_directory(const char *suspect)
 172{
 173        char path[PATH_MAX];
 174        size_t len = strlen(suspect);
 175
 176        if (PATH_MAX <= len + strlen("/objects"))
 177                die("Too long path: %.*s", 60, suspect);
 178        strcpy(path, suspect);
 179        if (getenv(DB_ENVIRONMENT)) {
 180                if (access(getenv(DB_ENVIRONMENT), X_OK))
 181                        return 0;
 182        }
 183        else {
 184                strcpy(path + len, "/objects");
 185                if (access(path, X_OK))
 186                        return 0;
 187        }
 188
 189        strcpy(path + len, "/refs");
 190        if (access(path, X_OK))
 191                return 0;
 192
 193        strcpy(path + len, "/HEAD");
 194        if (validate_headref(path))
 195                return 0;
 196
 197        return 1;
 198}
 199
 200int is_inside_git_dir(void)
 201{
 202        if (inside_git_dir < 0)
 203                inside_git_dir = is_inside_dir(get_git_dir());
 204        return inside_git_dir;
 205}
 206
 207int is_inside_work_tree(void)
 208{
 209        if (inside_work_tree < 0)
 210                inside_work_tree = is_inside_dir(get_git_work_tree());
 211        return inside_work_tree;
 212}
 213
 214void setup_work_tree(void)
 215{
 216        const char *work_tree, *git_dir;
 217        static int initialized = 0;
 218
 219        if (initialized)
 220                return;
 221        work_tree = get_git_work_tree();
 222        git_dir = get_git_dir();
 223        if (!is_absolute_path(git_dir))
 224                git_dir = make_absolute_path(git_dir);
 225        if (!work_tree || chdir(work_tree))
 226                die("This operation must be run in a work tree");
 227
 228        /*
 229         * Make sure subsequent git processes find correct worktree
 230         * if $GIT_WORK_TREE is set relative
 231         */
 232        if (getenv(GIT_WORK_TREE_ENVIRONMENT))
 233                setenv(GIT_WORK_TREE_ENVIRONMENT, ".", 1);
 234
 235        set_git_dir(make_relative_path(git_dir, work_tree));
 236        initialized = 1;
 237}
 238
 239static int check_repository_format_gently(const char *gitdir, int *nongit_ok)
 240{
 241        char repo_config[PATH_MAX+1];
 242
 243        /*
 244         * git_config() can't be used here because it calls git_pathdup()
 245         * to get $GIT_CONFIG/config. That call will make setup_git_env()
 246         * set git_dir to ".git".
 247         *
 248         * We are in gitdir setup, no git dir has been found useable yet.
 249         * Use a gentler version of git_config() to check if this repo
 250         * is a good one.
 251         */
 252        snprintf(repo_config, PATH_MAX, "%s/config", gitdir);
 253        git_config_early(check_repository_format_version, NULL, repo_config);
 254        if (GIT_REPO_VERSION < repository_format_version) {
 255                if (!nongit_ok)
 256                        die ("Expected git repo version <= %d, found %d",
 257                             GIT_REPO_VERSION, repository_format_version);
 258                warning("Expected git repo version <= %d, found %d",
 259                        GIT_REPO_VERSION, repository_format_version);
 260                warning("Please upgrade Git");
 261                *nongit_ok = -1;
 262                return -1;
 263        }
 264        return 0;
 265}
 266
 267/*
 268 * Try to read the location of the git directory from the .git file,
 269 * return path to git directory if found.
 270 */
 271const char *read_gitfile_gently(const char *path)
 272{
 273        char *buf;
 274        char *dir;
 275        const char *slash;
 276        struct stat st;
 277        int fd;
 278        size_t len;
 279
 280        if (stat(path, &st))
 281                return NULL;
 282        if (!S_ISREG(st.st_mode))
 283                return NULL;
 284        fd = open(path, O_RDONLY);
 285        if (fd < 0)
 286                die_errno("Error opening '%s'", path);
 287        buf = xmalloc(st.st_size + 1);
 288        len = read_in_full(fd, buf, st.st_size);
 289        close(fd);
 290        if (len != st.st_size)
 291                die("Error reading %s", path);
 292        buf[len] = '\0';
 293        if (prefixcmp(buf, "gitdir: "))
 294                die("Invalid gitfile format: %s", path);
 295        while (buf[len - 1] == '\n' || buf[len - 1] == '\r')
 296                len--;
 297        if (len < 9)
 298                die("No path in gitfile: %s", path);
 299        buf[len] = '\0';
 300        dir = buf + 8;
 301
 302        if (!is_absolute_path(dir) && (slash = strrchr(path, '/'))) {
 303                size_t pathlen = slash+1 - path;
 304                size_t dirlen = pathlen + len - 8;
 305                dir = xmalloc(dirlen + 1);
 306                strncpy(dir, path, pathlen);
 307                strncpy(dir + pathlen, buf + 8, len - 8);
 308                dir[dirlen] = '\0';
 309                free(buf);
 310                buf = dir;
 311        }
 312
 313        if (!is_git_directory(dir))
 314                die("Not a git repository: %s", dir);
 315        path = make_absolute_path(dir);
 316
 317        free(buf);
 318        return path;
 319}
 320
 321static const char *setup_explicit_git_dir(const char *gitdirenv,
 322                                          char *cwd, int len,
 323                                          int *nongit_ok)
 324{
 325        const char *work_tree_env = getenv(GIT_WORK_TREE_ENVIRONMENT);
 326        const char *worktree;
 327        char *gitfile;
 328
 329        if (PATH_MAX - 40 < strlen(gitdirenv))
 330                die("'$%s' too big", GIT_DIR_ENVIRONMENT);
 331
 332        gitfile = (char*)read_gitfile_gently(gitdirenv);
 333        if (gitfile) {
 334                gitfile = xstrdup(gitfile);
 335                gitdirenv = gitfile;
 336        }
 337
 338        if (!is_git_directory(gitdirenv)) {
 339                if (nongit_ok) {
 340                        *nongit_ok = 1;
 341                        free(gitfile);
 342                        return NULL;
 343                }
 344                die("Not a git repository: '%s'", gitdirenv);
 345        }
 346
 347        if (check_repository_format_gently(gitdirenv, nongit_ok)) {
 348                free(gitfile);
 349                return NULL;
 350        }
 351
 352        /* #3, #7, #11, #15, #19, #23, #27, #31 (see t1510) */
 353        if (work_tree_env)
 354                set_git_work_tree(work_tree_env);
 355        else if (is_bare_repository_cfg > 0) {
 356                if (git_work_tree_cfg) /* #22.2, #30 */
 357                        die("core.bare and core.worktree do not make sense");
 358
 359                /* #18, #26 */
 360                set_git_dir(gitdirenv);
 361                free(gitfile);
 362                return NULL;
 363        }
 364        else if (git_work_tree_cfg) { /* #6, #14 */
 365                if (is_absolute_path(git_work_tree_cfg))
 366                        set_git_work_tree(git_work_tree_cfg);
 367                else {
 368                        char core_worktree[PATH_MAX];
 369                        if (chdir(gitdirenv))
 370                                die_errno("Could not chdir to '%s'", gitdirenv);
 371                        if (chdir(git_work_tree_cfg))
 372                                die_errno("Could not chdir to '%s'", git_work_tree_cfg);
 373                        if (!getcwd(core_worktree, PATH_MAX))
 374                                die_errno("Could not get directory '%s'", git_work_tree_cfg);
 375                        if (chdir(cwd))
 376                                die_errno("Could not come back to cwd");
 377                        set_git_work_tree(core_worktree);
 378                }
 379        }
 380        else /* #2, #10 */
 381                set_git_work_tree(".");
 382
 383        /* set_git_work_tree() must have been called by now */
 384        worktree = get_git_work_tree();
 385
 386        /* both get_git_work_tree() and cwd are already normalized */
 387        if (!strcmp(cwd, worktree)) { /* cwd == worktree */
 388                set_git_dir(gitdirenv);
 389                free(gitfile);
 390                return NULL;
 391        }
 392
 393        if (!prefixcmp(cwd, worktree) &&
 394            cwd[strlen(worktree)] == '/') { /* cwd inside worktree */
 395                set_git_dir(make_absolute_path(gitdirenv));
 396                if (chdir(worktree))
 397                        die_errno("Could not chdir to '%s'", worktree);
 398                cwd[len++] = '/';
 399                cwd[len] = '\0';
 400                free(gitfile);
 401                return cwd + strlen(worktree) + 1;
 402        }
 403
 404        /* cwd outside worktree */
 405        set_git_dir(gitdirenv);
 406        free(gitfile);
 407        return NULL;
 408}
 409
 410static const char *setup_discovered_git_dir(const char *gitdir,
 411                                            char *cwd, int offset, int len,
 412                                            int *nongit_ok)
 413{
 414        if (check_repository_format_gently(gitdir, nongit_ok))
 415                return NULL;
 416
 417        /* --work-tree is set without --git-dir; use discovered one */
 418        if (getenv(GIT_WORK_TREE_ENVIRONMENT) || git_work_tree_cfg) {
 419                if (offset != len && !is_absolute_path(gitdir))
 420                        gitdir = xstrdup(make_absolute_path(gitdir));
 421                if (chdir(cwd))
 422                        die_errno("Could not come back to cwd");
 423                return setup_explicit_git_dir(gitdir, cwd, len, nongit_ok);
 424        }
 425
 426        /* #16.2, #17.2, #20.2, #21.2, #24, #25, #28, #29 (see t1510) */
 427        if (is_bare_repository_cfg > 0) {
 428                set_git_dir(offset == len ? gitdir : make_absolute_path(gitdir));
 429                if (chdir(cwd))
 430                        die_errno("Could not come back to cwd");
 431                return NULL;
 432        }
 433
 434        /* #0, #1, #5, #8, #9, #12, #13 */
 435        set_git_work_tree(".");
 436        if (strcmp(gitdir, DEFAULT_GIT_DIR_ENVIRONMENT))
 437                set_git_dir(gitdir);
 438        inside_git_dir = 0;
 439        inside_work_tree = 1;
 440        if (offset == len)
 441                return NULL;
 442
 443        /* Make "offset" point to past the '/', and add a '/' at the end */
 444        offset++;
 445        cwd[len++] = '/';
 446        cwd[len] = 0;
 447        return cwd + offset;
 448}
 449
 450/* #16.1, #17.1, #20.1, #21.1, #22.1 (see t1510) */
 451static const char *setup_bare_git_dir(char *cwd, int offset, int len, int *nongit_ok)
 452{
 453        int root_len;
 454
 455        if (check_repository_format_gently(".", nongit_ok))
 456                return NULL;
 457
 458        /* --work-tree is set without --git-dir; use discovered one */
 459        if (getenv(GIT_WORK_TREE_ENVIRONMENT) || git_work_tree_cfg) {
 460                const char *gitdir;
 461
 462                gitdir = offset == len ? "." : xmemdupz(cwd, offset);
 463                if (chdir(cwd))
 464                        die_errno("Could not come back to cwd");
 465                return setup_explicit_git_dir(gitdir, cwd, len, nongit_ok);
 466        }
 467
 468        inside_git_dir = 1;
 469        inside_work_tree = 0;
 470        if (offset != len) {
 471                if (chdir(cwd))
 472                        die_errno("Cannot come back to cwd");
 473                root_len = offset_1st_component(cwd);
 474                cwd[offset > root_len ? offset : root_len] = '\0';
 475                set_git_dir(cwd);
 476        }
 477        else
 478                set_git_dir(".");
 479        return NULL;
 480}
 481
 482static const char *setup_nongit(const char *cwd, int *nongit_ok)
 483{
 484        if (!nongit_ok)
 485                die("Not a git repository (or any of the parent directories): %s", DEFAULT_GIT_DIR_ENVIRONMENT);
 486        if (chdir(cwd))
 487                die_errno("Cannot come back to cwd");
 488        *nongit_ok = 1;
 489        return NULL;
 490}
 491
 492static dev_t get_device_or_die(const char *path, const char *prefix)
 493{
 494        struct stat buf;
 495        if (stat(path, &buf))
 496                die_errno("failed to stat '%s%s%s'",
 497                                prefix ? prefix : "",
 498                                prefix ? "/" : "", path);
 499        return buf.st_dev;
 500}
 501
 502/*
 503 * We cannot decide in this function whether we are in the work tree or
 504 * not, since the config can only be read _after_ this function was called.
 505 */
 506static const char *setup_git_directory_gently_1(int *nongit_ok)
 507{
 508        const char *env_ceiling_dirs = getenv(CEILING_DIRECTORIES_ENVIRONMENT);
 509        static char cwd[PATH_MAX+1];
 510        const char *gitdirenv, *ret;
 511        char *gitfile;
 512        int len, offset, ceil_offset;
 513        dev_t current_device = 0;
 514        int one_filesystem = 1;
 515
 516        /*
 517         * Let's assume that we are in a git repository.
 518         * If it turns out later that we are somewhere else, the value will be
 519         * updated accordingly.
 520         */
 521        if (nongit_ok)
 522                *nongit_ok = 0;
 523
 524        if (!getcwd(cwd, sizeof(cwd)-1))
 525                die_errno("Unable to read current working directory");
 526        offset = len = strlen(cwd);
 527
 528        /*
 529         * If GIT_DIR is set explicitly, we're not going
 530         * to do any discovery, but we still do repository
 531         * validation.
 532         */
 533        gitdirenv = getenv(GIT_DIR_ENVIRONMENT);
 534        if (gitdirenv)
 535                return setup_explicit_git_dir(gitdirenv, cwd, len, nongit_ok);
 536
 537        ceil_offset = longest_ancestor_length(cwd, env_ceiling_dirs);
 538        if (ceil_offset < 0 && has_dos_drive_prefix(cwd))
 539                ceil_offset = 1;
 540
 541        /*
 542         * Test in the following order (relative to the cwd):
 543         * - .git (file containing "gitdir: <path>")
 544         * - .git/
 545         * - ./ (bare)
 546         * - ../.git
 547         * - ../.git/
 548         * - ../ (bare)
 549         * - ../../.git/
 550         *   etc.
 551         */
 552        one_filesystem = !git_env_bool("GIT_DISCOVERY_ACROSS_FILESYSTEM", 0);
 553        if (one_filesystem)
 554                current_device = get_device_or_die(".", NULL);
 555        for (;;) {
 556                gitfile = (char*)read_gitfile_gently(DEFAULT_GIT_DIR_ENVIRONMENT);
 557                if (gitfile)
 558                        gitdirenv = gitfile = xstrdup(gitfile);
 559                else {
 560                        if (is_git_directory(DEFAULT_GIT_DIR_ENVIRONMENT))
 561                                gitdirenv = DEFAULT_GIT_DIR_ENVIRONMENT;
 562                }
 563
 564                if (gitdirenv) {
 565                        ret = setup_discovered_git_dir(gitdirenv,
 566                                                       cwd, offset, len,
 567                                                       nongit_ok);
 568                        free(gitfile);
 569                        return ret;
 570                }
 571                free(gitfile);
 572
 573                if (is_git_directory("."))
 574                        return setup_bare_git_dir(cwd, offset, len, nongit_ok);
 575
 576                while (--offset > ceil_offset && cwd[offset] != '/');
 577                if (offset <= ceil_offset)
 578                        return setup_nongit(cwd, nongit_ok);
 579                if (one_filesystem) {
 580                        dev_t parent_device = get_device_or_die("..", cwd);
 581                        if (parent_device != current_device) {
 582                                if (nongit_ok) {
 583                                        if (chdir(cwd))
 584                                                die_errno("Cannot come back to cwd");
 585                                        *nongit_ok = 1;
 586                                        return NULL;
 587                                }
 588                                cwd[offset] = '\0';
 589                                die("Not a git repository (or any parent up to mount parent %s)\n"
 590                                "Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).", cwd);
 591                        }
 592                }
 593                if (chdir("..")) {
 594                        cwd[offset] = '\0';
 595                        die_errno("Cannot change to '%s/..'", cwd);
 596                }
 597        }
 598}
 599
 600const char *setup_git_directory_gently(int *nongit_ok)
 601{
 602        const char *prefix;
 603
 604        prefix = setup_git_directory_gently_1(nongit_ok);
 605        if (startup_info) {
 606                startup_info->have_repository = !nongit_ok || !*nongit_ok;
 607                startup_info->prefix = prefix;
 608        }
 609        return prefix;
 610}
 611
 612int git_config_perm(const char *var, const char *value)
 613{
 614        int i;
 615        char *endptr;
 616
 617        if (value == NULL)
 618                return PERM_GROUP;
 619
 620        if (!strcmp(value, "umask"))
 621                return PERM_UMASK;
 622        if (!strcmp(value, "group"))
 623                return PERM_GROUP;
 624        if (!strcmp(value, "all") ||
 625            !strcmp(value, "world") ||
 626            !strcmp(value, "everybody"))
 627                return PERM_EVERYBODY;
 628
 629        /* Parse octal numbers */
 630        i = strtol(value, &endptr, 8);
 631
 632        /* If not an octal number, maybe true/false? */
 633        if (*endptr != 0)
 634                return git_config_bool(var, value) ? PERM_GROUP : PERM_UMASK;
 635
 636        /*
 637         * Treat values 0, 1 and 2 as compatibility cases, otherwise it is
 638         * a chmod value to restrict to.
 639         */
 640        switch (i) {
 641        case PERM_UMASK:               /* 0 */
 642                return PERM_UMASK;
 643        case OLD_PERM_GROUP:           /* 1 */
 644                return PERM_GROUP;
 645        case OLD_PERM_EVERYBODY:       /* 2 */
 646                return PERM_EVERYBODY;
 647        }
 648
 649        /* A filemode value was given: 0xxx */
 650
 651        if ((i & 0600) != 0600)
 652                die("Problem with core.sharedRepository filemode value "
 653                    "(0%.3o).\nThe owner of files must always have "
 654                    "read and write permissions.", i);
 655
 656        /*
 657         * Mask filemode value. Others can not get write permission.
 658         * x flags for directories are handled separately.
 659         */
 660        return -(i & 0666);
 661}
 662
 663int check_repository_format_version(const char *var, const char *value, void *cb)
 664{
 665        if (strcmp(var, "core.repositoryformatversion") == 0)
 666                repository_format_version = git_config_int(var, value);
 667        else if (strcmp(var, "core.sharedrepository") == 0)
 668                shared_repository = git_config_perm(var, value);
 669        else if (strcmp(var, "core.bare") == 0) {
 670                is_bare_repository_cfg = git_config_bool(var, value);
 671                if (is_bare_repository_cfg == 1)
 672                        inside_work_tree = -1;
 673        } else if (strcmp(var, "core.worktree") == 0) {
 674                if (!value)
 675                        return config_error_nonbool(var);
 676                free(git_work_tree_cfg);
 677                git_work_tree_cfg = xstrdup(value);
 678                inside_work_tree = -1;
 679        }
 680        return 0;
 681}
 682
 683int check_repository_format(void)
 684{
 685        return check_repository_format_gently(get_git_dir(), NULL);
 686}
 687
 688/*
 689 * Returns the "prefix", a path to the current working directory
 690 * relative to the work tree root, or NULL, if the current working
 691 * directory is not a strict subdirectory of the work tree root. The
 692 * prefix always ends with a '/' character.
 693 */
 694const char *setup_git_directory(void)
 695{
 696        return setup_git_directory_gently(NULL);
 697}