builtin/commit-graph.c

   1 #include "builtin.h"
   2 #include "config.h"
   3 #include "dir.h"
   4 #include "environment.h"
   5 #include "gettext.h"
   6 #include "hex.h"
   7 #include "lockfile.h"
   8 #include "parse-options.h"
   9 #include "repository.h"
  10 #include "commit-graph.h"
  11 #include "object-store.h"
  12 #include "progress.h"
  13 #include "replace-object.h"
  14 #include "tag.h"
  15 #include "trace2.h"
  16
  17 #define BUILTIN_COMMIT_GRAPH_VERIFY_USAGE \
  18         N_("git commit-graph verify [--object-dir <dir>] [--shallow] [--[no-]progress]")
  19
  20 #define BUILTIN_COMMIT_GRAPH_WRITE_USAGE \
  21         N_("git commit-graph write [--object-dir <dir>] [--append]\n" \
  22            "                       [--split[=<strategy>]] [--reachable | --stdin-packs | --stdin-commits]\n" \
  23            "                       [--changed-paths] [--[no-]max-new-filters <n>] [--[no-]progress]\n" \
  24            "                       <split options>")
  25
  26 static const char * builtin_commit_graph_verify_usage[] = {
  27         BUILTIN_COMMIT_GRAPH_VERIFY_USAGE,
  28         NULL
  29 };
  30
  31 static const char * builtin_commit_graph_write_usage[] = {
  32         BUILTIN_COMMIT_GRAPH_WRITE_USAGE,
  33         NULL
  34 };
  35
  36 static char const * const builtin_commit_graph_usage[] = {
  37         BUILTIN_COMMIT_GRAPH_VERIFY_USAGE,
  38         BUILTIN_COMMIT_GRAPH_WRITE_USAGE,
  39         NULL,
  40 };
  41
  42 static struct opts_commit_graph {
  43         const char *obj_dir;
  44         int reachable;
  45         int stdin_packs;
  46         int stdin_commits;
  47         int append;
  48         int split;
  49         int shallow;
  50         int progress;
  51         int enable_changed_paths;
  52 } opts;
  53
  54 static struct option common_opts[] = {
  55         OPT_STRING(0, "object-dir", &opts.obj_dir,
  56                    N_("dir"),
  57                    N_("the object directory to store the graph")),
  58         OPT_END()
  59 };
  60
  61 static struct option *add_common_options(struct option *to)
  62 {
  63         return parse_options_concat(common_opts, to);
  64 }
  65
  66 static int graph_verify(int argc, const char **argv, const char *prefix)
  67 {
  68         struct commit_graph *graph = NULL;
  69         struct object_directory *odb = NULL;
  70         char *graph_name;
  71         int open_ok;
  72         int fd;
  73         struct stat st;
  74         int flags = 0;
  75         int ret;
  76
  77         static struct option builtin_commit_graph_verify_options[] = {
  78                 OPT_BOOL(0, "shallow", &opts.shallow,
  79                          N_("if the commit-graph is split, only verify the tip file")),
  80                 OPT_BOOL(0, "progress", &opts.progress,
  81                          N_("force progress reporting")),
  82                 OPT_END(),
  83         };
  84         struct option *options = add_common_options(builtin_commit_graph_verify_options);
  85
  86         trace2_cmd_mode("verify");
  87
  88         opts.progress = isatty(2);
  89         argc = parse_options(argc, argv, prefix,
  90                              options,
  91                              builtin_commit_graph_verify_usage, 0);
  92         if (argc)
  93                 usage_with_options(builtin_commit_graph_verify_usage, options);
  94
  95         if (!opts.obj_dir)
  96                 opts.obj_dir = get_object_directory();
  97         if (opts.shallow)
  98                 flags |= COMMIT_GRAPH_VERIFY_SHALLOW;
  99         if (opts.progress)
 100                 flags |= COMMIT_GRAPH_WRITE_PROGRESS;
 101
 102         odb = find_odb(the_repository, opts.obj_dir);
 103         graph_name = get_commit_graph_filename(odb);
 104         open_ok = open_commit_graph(graph_name, &fd, &st);
 105         if (!open_ok && errno != ENOENT)
 106                 die_errno(_("Could not open commit-graph '%s'"), graph_name);
 107
 108         FREE_AND_NULL(graph_name);
 109         FREE_AND_NULL(options);
 110
 111         if (open_ok)
 112                 graph = load_commit_graph_one_fd_st(the_repository, fd, &st, odb);
 113         else
 114                 graph = read_commit_graph_one(the_repository, odb);
 115
 116         /* Return failure if open_ok predicted success */
 117         if (!graph)
 118                 return !!open_ok;
 119
 120         ret = verify_commit_graph(the_repository, graph, flags);
 121         free_commit_graph(graph);
 122         return ret;
 123 }
 124
 125 extern int read_replace_refs;
 126 static struct commit_graph_opts write_opts;
 127
 128 static int write_option_parse_split(const struct option *opt, const char *arg,
 129                                     int unset)
 130 {
 131         enum commit_graph_split_flags *flags = opt->value;
 132
 133         BUG_ON_OPT_NEG(unset);
 134
 135         opts.split = 1;
 136         if (!arg)
 137                 return 0;
 138
 139         if (!strcmp(arg, "no-merge"))
 140                 *flags = COMMIT_GRAPH_SPLIT_MERGE_PROHIBITED;
 141         else if (!strcmp(arg, "replace"))
 142                 *flags = COMMIT_GRAPH_SPLIT_REPLACE;
 143         else
 144                 die(_("unrecognized --split argument, %s"), arg);
 145
 146         return 0;
 147 }
 148
 149 static int read_one_commit(struct oidset *commits, struct progress *progress,
 150                            const char *hash)
 151 {
 152         struct object *result;
 153         struct object_id oid;
 154         const char *end;
 155
 156         if (parse_oid_hex(hash, &oid, &end))
 157                 return error(_("unexpected non-hex object ID: %s"), hash);
 158
 159         result = deref_tag(the_repository, parse_object(the_repository, &oid),
 160                            NULL, 0);
 161         if (!result)
 162                 return error(_("invalid object: %s"), hash);
 163         else if (object_as_type(result, OBJ_COMMIT, 1))
 164                 oidset_insert(commits, &result->oid);
 165
 166         display_progress(progress, oidset_size(commits));
 167
 168         return 0;
 169 }
 170
 171 static int write_option_max_new_filters(const struct option *opt,
 172                                         const char *arg,
 173                                         int unset)
 174 {
 175         int *to = opt->value;
 176         if (unset)
 177                 *to = -1;
 178         else {
 179                 const char *s;
 180                 *to = strtol(arg, (char **)&s, 10);
 181                 if (*s)
 182                         return error(_("option `%s' expects a numerical value"),
 183                                      "max-new-filters");
 184         }
 185         return 0;
 186 }
 187
 188 static int git_commit_graph_write_config(const char *var, const char *value,
 189                                          const struct config_context *ctx,
 190                                          void *cb UNUSED)
 191 {
 192         if (!strcmp(var, "commitgraph.maxnewfilters"))
 193                 write_opts.max_new_filters = git_config_int(var, value, ctx->kvi);
 194         /*
 195          * No need to fall-back to 'git_default_config', since this was already
 196          * called in 'cmd_commit_graph()'.
 197          */
 198         return 0;
 199 }
 200
 201 static int graph_write(int argc, const char **argv, const char *prefix)
 202 {
 203         struct string_list pack_indexes = STRING_LIST_INIT_DUP;
 204         struct strbuf buf = STRBUF_INIT;
 205         struct oidset commits = OIDSET_INIT;
 206         struct object_directory *odb = NULL;
 207         int result = 0;
 208         enum commit_graph_write_flags flags = 0;
 209         struct progress *progress = NULL;
 210
 211         static struct option builtin_commit_graph_write_options[] = {
 212                 OPT_BOOL(0, "reachable", &opts.reachable,
 213                         N_("start walk at all refs")),
 214                 OPT_BOOL(0, "stdin-packs", &opts.stdin_packs,
 215                         N_("scan pack-indexes listed by stdin for commits")),
 216                 OPT_BOOL(0, "stdin-commits", &opts.stdin_commits,
 217                         N_("start walk at commits listed by stdin")),
 218                 OPT_BOOL(0, "append", &opts.append,
 219                         N_("include all commits already in the commit-graph file")),
 220                 OPT_BOOL(0, "changed-paths", &opts.enable_changed_paths,
 221                         N_("enable computation for changed paths")),
 222                 OPT_CALLBACK_F(0, "split", &write_opts.split_flags, NULL,
 223                         N_("allow writing an incremental commit-graph file"),
 224                         PARSE_OPT_OPTARG | PARSE_OPT_NONEG,
 225                         write_option_parse_split),
 226                 OPT_INTEGER(0, "max-commits", &write_opts.max_commits,
 227                         N_("maximum number of commits in a non-base split commit-graph")),
 228                 OPT_INTEGER(0, "size-multiple", &write_opts.size_multiple,
 229                         N_("maximum ratio between two levels of a split commit-graph")),
 230                 OPT_EXPIRY_DATE(0, "expire-time", &write_opts.expire_time,
 231                         N_("only expire files older than a given date-time")),
 232                 OPT_CALLBACK_F(0, "max-new-filters", &write_opts.max_new_filters,
 233                         NULL, N_("maximum number of changed-path Bloom filters to compute"),
 234                         0, write_option_max_new_filters),
 235                 OPT_BOOL(0, "progress", &opts.progress,
 236                          N_("force progress reporting")),
 237                 OPT_END(),
 238         };
 239         struct option *options = add_common_options(builtin_commit_graph_write_options);
 240
 241         opts.progress = isatty(2);
 242         opts.enable_changed_paths = -1;
 243         write_opts.size_multiple = 2;
 244         write_opts.max_commits = 0;
 245         write_opts.expire_time = 0;
 246         write_opts.max_new_filters = -1;
 247
 248         trace2_cmd_mode("write");
 249
 250         git_config(git_commit_graph_write_config, &opts);
 251
 252         argc = parse_options(argc, argv, prefix,
 253                              options,
 254                              builtin_commit_graph_write_usage, 0);
 255         if (argc)
 256                 usage_with_options(builtin_commit_graph_write_usage, options);
 257
 258         if (opts.reachable + opts.stdin_packs + opts.stdin_commits > 1)
 259                 die(_("use at most one of --reachable, --stdin-commits, or --stdin-packs"));
 260         if (!opts.obj_dir)
 261                 opts.obj_dir = get_object_directory();
 262         if (opts.append)
 263                 flags |= COMMIT_GRAPH_WRITE_APPEND;
 264         if (opts.split)
 265                 flags |= COMMIT_GRAPH_WRITE_SPLIT;
 266         if (opts.progress)
 267                 flags |= COMMIT_GRAPH_WRITE_PROGRESS;
 268         if (!opts.enable_changed_paths)
 269                 flags |= COMMIT_GRAPH_NO_WRITE_BLOOM_FILTERS;
 270         if (opts.enable_changed_paths == 1 ||
 271             git_env_bool(GIT_TEST_COMMIT_GRAPH_CHANGED_PATHS, 0))
 272                 flags |= COMMIT_GRAPH_WRITE_BLOOM_FILTERS;
 273
 274         odb = find_odb(the_repository, opts.obj_dir);
 275
 276         if (opts.reachable) {
 277                 if (write_commit_graph_reachable(odb, flags, &write_opts))
 278                         result = 1;
 279                 goto cleanup;
 280         }
 281
 282         if (opts.stdin_packs) {
 283                 while (strbuf_getline(&buf, stdin) != EOF)
 284                         string_list_append_nodup(&pack_indexes,
 285                                                  strbuf_detach(&buf, NULL));
 286         } else if (opts.stdin_commits) {
 287                 oidset_init(&commits, 0);
 288                 if (opts.progress)
 289                         progress = start_delayed_progress(
 290                                 _("Collecting commits from input"), 0);
 291
 292                 while (strbuf_getline(&buf, stdin) != EOF) {
 293                         if (read_one_commit(&commits, progress, buf.buf)) {
 294                                 result = 1;
 295                                 goto cleanup;
 296                         }
 297                 }
 298
 299                 stop_progress(&progress);
 300         }
 301
 302         if (write_commit_graph(odb,
 303                                opts.stdin_packs ? &pack_indexes : NULL,
 304                                opts.stdin_commits ? &commits : NULL,
 305                                flags,
 306                                &write_opts))
 307                 result = 1;
 308
 309 cleanup:
 310         FREE_AND_NULL(options);
 311         string_list_clear(&pack_indexes, 0);
 312         strbuf_release(&buf);
 313         return result;
 314 }
 315
 316 int cmd_commit_graph(int argc, const char **argv, const char *prefix)
 317 {
 318         parse_opt_subcommand_fn *fn = NULL;
 319         struct option builtin_commit_graph_options[] = {
 320                 OPT_SUBCOMMAND("verify", &fn, graph_verify),
 321                 OPT_SUBCOMMAND("write", &fn, graph_write),
 322                 OPT_END(),
 323         };
 324         struct option *options = parse_options_concat(builtin_commit_graph_options, common_opts);
 325
 326         git_config(git_default_config, NULL);
 327
 328         disable_replace_refs();
 329         save_commit_buffer = 0;
 330
 331         argc = parse_options(argc, argv, prefix, options,
 332                              builtin_commit_graph_usage, 0);
 333         FREE_AND_NULL(options);
 334
 335         return fn(argc, argv, prefix);
 336 }