setup.h

   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 #define READ_GITFILE_ERR_STAT_FAILED 1
  32 #define READ_GITFILE_ERR_NOT_A_FILE 2
  33 #define READ_GITFILE_ERR_OPEN_FAILED 3
  34 #define READ_GITFILE_ERR_READ_FAILED 4
  35 #define READ_GITFILE_ERR_INVALID_FORMAT 5
  36 #define READ_GITFILE_ERR_NO_PATH 6
  37 #define READ_GITFILE_ERR_NOT_A_REPO 7
  38 #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 #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 {
  92         if (discover_git_directory_reason(commondir, gitdir) <= 0)
  93                 return -1;
  94         return 0;
  95 }
  96
  97 void set_git_dir(const char *path, int make_realpath);
  98 void set_git_work_tree(const char *tree);
  99
 100 const char *setup_git_directory_gently(int *);
 101 const char *setup_git_directory(void);
 102 char *prefix_path(const char *prefix, int len, const char *path);
 103 char *prefix_path_gently(const char *prefix, int len, int *remaining, const char *path);
 104
 105 int check_filename(const char *prefix, const char *name);
 106 void verify_filename(const char *prefix,
 107                      const char *name,
 108                      int diagnose_misspelt_rev);
 109 void verify_non_filename(const char *prefix, const char *name);
 110 int path_inside_repo(const char *prefix, const char *path);
 111
 112 void sanitize_stdfds(void);
 113 int daemonize(void);
 114
 115 /*
 116  * GIT_REPO_VERSION is the version we write by default. The
 117  * _READ variant is the highest number we know how to
 118  * handle.
 119  */
 120 #define GIT_REPO_VERSION 0
 121 #define GIT_REPO_VERSION_READ 1
 122
 123 /*
 124  * You _have_ to initialize a `struct repository_format` using
 125  * `= REPOSITORY_FORMAT_INIT` before calling `read_repository_format()`.
 126  */
 127 struct repository_format {
 128         int version;
 129         int precious_objects;
 130         char *partial_clone; /* value of extensions.partialclone */
 131         int worktree_config;
 132         int is_bare;
 133         int hash_algo;
 134         int compat_hash_algo;
 135         enum ref_storage_format ref_storage_format;
 136         int sparse_index;
 137         char *work_tree;
 138         struct string_list unknown_extensions;
 139         struct string_list v1_only_extensions;
 140 };
 141
 142 /*
 143  * Always use this to initialize a `struct repository_format`
 144  * to a well-defined, default state before calling
 145  * `read_repository()`.
 146  */
 147 #define REPOSITORY_FORMAT_INIT \
 148 { \
 149         .version = -1, \
 150         .is_bare = -1, \
 151         .hash_algo = GIT_HASH_SHA1, \
 152         .ref_storage_format = REF_STORAGE_FORMAT_FILES, \
 153         .unknown_extensions = STRING_LIST_INIT_DUP, \
 154         .v1_only_extensions = STRING_LIST_INIT_DUP, \
 155 }
 156
 157 /*
 158  * Read the repository format characteristics from the config file "path" into
 159  * "format" struct. Returns the numeric version. On error, or if no version is
 160  * found in the configuration, -1 is returned, format->version is set to -1,
 161  * and all other fields in the struct are set to the default configuration
 162  * (REPOSITORY_FORMAT_INIT). Always initialize the struct using
 163  * REPOSITORY_FORMAT_INIT before calling this function.
 164  */
 165 int read_repository_format(struct repository_format *format, const char *path);
 166
 167 /*
 168  * Free the memory held onto by `format`, but not the struct itself.
 169  * (No need to use this after `read_repository_format()` fails.)
 170  */
 171 void clear_repository_format(struct repository_format *format);
 172
 173 /*
 174  * Verify that the repository described by repository_format is something we
 175  * can read. If it is, return 0. Otherwise, return -1, and "err" will describe
 176  * any errors encountered.
 177  */
 178 int verify_repository_format(const struct repository_format *format,
 179                              struct strbuf *err);
 180
 181 /*
 182  * Check the repository format version in the path found in repo_get_git_dir(the_repository),
 183  * and die if it is a version we don't understand. Generally one would
 184  * set_git_dir() before calling this, and use it only for "are we in a valid
 185  * repo?".
 186  *
 187  * If successful and fmt is not NULL, fill fmt with data.
 188  */
 189 void check_repository_format(struct repository_format *fmt);
 190
 191 const char *get_template_dir(const char *option_template);
 192
 193 #define INIT_DB_QUIET      (1 << 0)
 194 #define INIT_DB_EXIST_OK   (1 << 1)
 195 #define INIT_DB_SKIP_REFDB (1 << 2)
 196
 197 int init_db(const char *git_dir, const char *real_git_dir,
 198             const char *template_dir, int hash_algo,
 199             enum ref_storage_format ref_storage_format,
 200             const char *initial_branch, int init_shared_repository,
 201             unsigned int flags);
 202 void initialize_repository_version(int hash_algo,
 203                                    enum ref_storage_format ref_storage_format,
 204                                    int reinit);
 205 void create_reference_database(enum ref_storage_format ref_storage_format,
 206                                const char *initial_branch, int quiet);
 207
 208 /*
 209  * NOTE NOTE NOTE!!
 210  *
 211  * PERM_UMASK, OLD_PERM_GROUP and OLD_PERM_EVERYBODY enumerations must
 212  * not be changed. Old repositories have core.sharedrepository written in
 213  * numeric format, and therefore these values are preserved for compatibility
 214  * reasons.
 215  */
 216 enum sharedrepo {
 217         PERM_UMASK          = 0,
 218         OLD_PERM_GROUP      = 1,
 219         OLD_PERM_EVERYBODY  = 2,
 220         PERM_GROUP          = 0660,
 221         PERM_EVERYBODY      = 0664
 222 };
 223 int git_config_perm(const char *var, const char *value);
 224
 225 struct startup_info {
 226         int have_repository;
 227         const char *prefix;
 228         const char *original_cwd;
 229 };
 230 extern struct startup_info *startup_info;
 231 extern const char *tmp_original_cwd;
 232
 233 #endif /* SETUP_H */