builtin/rm.c

   1 /*
   2  * "git rm" builtin command
   3  *
   4  * Copyright (C) Linus Torvalds 2006
   5  */
   6 #include "builtin.h"
   7 #include "lockfile.h"
   8 #include "dir.h"
   9 #include "cache-tree.h"
  10 #include "tree-walk.h"
  11 #include "parse-options.h"
  12 #include "string-list.h"
  13 #include "submodule.h"
  14 #include "pathspec.h"
  15
  16 static const char * const builtin_rm_usage[] = {
  17         N_("git rm [<options>] [--] <file>..."),
  18         NULL
  19 };
  20
  21 static struct {
  22         int nr, alloc;
  23         struct {
  24                 const char *name;
  25                 char is_submodule;
  26         } *entry;
  27 } list;
  28
  29 static int get_ours_cache_pos(const char *path, int pos)
  30 {
  31         int i = -pos - 1;
  32
  33         while ((i < active_nr) && !strcmp(active_cache[i]->name, path)) {
  34                 if (ce_stage(active_cache[i]) == 2)
  35                         return i;
  36                 i++;
  37         }
  38         return -1;
  39 }
  40
  41 static void print_error_files(struct string_list *files_list,
  42                               const char *main_msg,
  43                               const char *hints_msg,
  44                               int *errs)
  45 {
  46         if (files_list->nr) {
  47                 int i;
  48                 struct strbuf err_msg = STRBUF_INIT;
  49
  50                 strbuf_addstr(&err_msg, main_msg);
  51                 for (i = 0; i < files_list->nr; i++)
  52                         strbuf_addf(&err_msg,
  53                                     "\n    %s",
  54                                     files_list->items[i].string);
  55                 if (advice_rm_hints)
  56                         strbuf_addstr(&err_msg, hints_msg);
  57                 *errs = error("%s", err_msg.buf);
  58                 strbuf_release(&err_msg);
  59         }
  60 }
  61
  62 static void error_removing_concrete_submodules(struct string_list *files, int *errs)
  63 {
  64         print_error_files(files,
  65                           Q_("the following submodule (or one of its nested "
  66                              "submodules)\n"
  67                              "uses a .git directory:",
  68                              "the following submodules (or one of their nested "
  69                              "submodules)\n"
  70                              "use a .git directory:", files->nr),
  71                           _("\n(use 'rm -rf' if you really want to remove "
  72                             "it including all of its history)"),
  73                           errs);
  74         string_list_clear(files, 0);
  75 }
  76
  77 static int check_submodules_use_gitfiles(void)
  78 {
  79         int i;
  80         int errs = 0;
  81         struct string_list files = STRING_LIST_INIT_NODUP;
  82
  83         for (i = 0; i < list.nr; i++) {
  84                 const char *name = list.entry[i].name;
  85                 int pos;
  86                 const struct cache_entry *ce;
  87
  88                 pos = cache_name_pos(name, strlen(name));
  89                 if (pos < 0) {
  90                         pos = get_ours_cache_pos(name, pos);
  91                         if (pos < 0)
  92                                 continue;
  93                 }
  94                 ce = active_cache[pos];
  95
  96                 if (!S_ISGITLINK(ce->ce_mode) ||
  97                     !file_exists(ce->name) ||
  98                     is_empty_dir(name))
  99                         continue;
 100
 101                 if (!submodule_uses_gitfile(name))
 102                         string_list_append(&files, name);
 103         }
 104
 105         error_removing_concrete_submodules(&files, &errs);
 106
 107         return errs;
 108 }
 109
 110 static int check_local_mod(struct object_id *head, int index_only)
 111 {
 112         /*
 113          * Items in list are already sorted in the cache order,
 114          * so we could do this a lot more efficiently by using
 115          * tree_desc based traversal if we wanted to, but I am
 116          * lazy, and who cares if removal of files is a tad
 117          * slower than the theoretical maximum speed?
 118          */
 119         int i, no_head;
 120         int errs = 0;
 121         struct string_list files_staged = STRING_LIST_INIT_NODUP;
 122         struct string_list files_cached = STRING_LIST_INIT_NODUP;
 123         struct string_list files_submodule = STRING_LIST_INIT_NODUP;
 124         struct string_list files_local = STRING_LIST_INIT_NODUP;
 125
 126         no_head = is_null_oid(head);
 127         for (i = 0; i < list.nr; i++) {
 128                 struct stat st;
 129                 int pos;
 130                 const struct cache_entry *ce;
 131                 const char *name = list.entry[i].name;
 132                 struct object_id oid;
 133                 unsigned mode;
 134                 int local_changes = 0;
 135                 int staged_changes = 0;
 136
 137                 pos = cache_name_pos(name, strlen(name));
 138                 if (pos < 0) {
 139                         /*
 140                          * Skip unmerged entries except for populated submodules
 141                          * that could lose history when removed.
 142                          */
 143                         pos = get_ours_cache_pos(name, pos);
 144                         if (pos < 0)
 145                                 continue;
 146
 147                         if (!S_ISGITLINK(active_cache[pos]->ce_mode) ||
 148                             is_empty_dir(name))
 149                                 continue;
 150                 }
 151                 ce = active_cache[pos];
 152
 153                 if (lstat(ce->name, &st) < 0) {
 154                         if (errno != ENOENT && errno != ENOTDIR)
 155                                 warning_errno(_("failed to stat '%s'"), ce->name);
 156                         /* It already vanished from the working tree */
 157                         continue;
 158                 }
 159                 else if (S_ISDIR(st.st_mode)) {
 160                         /* if a file was removed and it is now a
 161                          * directory, that is the same as ENOENT as
 162                          * far as git is concerned; we do not track
 163                          * directories unless they are submodules.
 164                          */
 165                         if (!S_ISGITLINK(ce->ce_mode))
 166                                 continue;
 167                 }
 168
 169                 /*
 170                  * "rm" of a path that has changes need to be treated
 171                  * carefully not to allow losing local changes
 172                  * accidentally.  A local change could be (1) file in
 173                  * work tree is different since the index; and/or (2)
 174                  * the user staged a content that is different from
 175                  * the current commit in the index.
 176                  *
 177                  * In such a case, you would need to --force the
 178                  * removal.  However, "rm --cached" (remove only from
 179                  * the index) is safe if the index matches the file in
 180                  * the work tree or the HEAD commit, as it means that
 181                  * the content being removed is available elsewhere.
 182                  */
 183
 184                 /*
 185                  * Is the index different from the file in the work tree?
 186                  * If it's a submodule, is its work tree modified?
 187                  */
 188                 if (ce_match_stat(ce, &st, 0) ||
 189                     (S_ISGITLINK(ce->ce_mode) &&
 190                      !ok_to_remove_submodule(ce->name)))
 191                         local_changes = 1;
 192
 193                 /*
 194                  * Is the index different from the HEAD commit?  By
 195                  * definition, before the very initial commit,
 196                  * anything staged in the index is treated by the same
 197                  * way as changed from the HEAD.
 198                  */
 199                 if (no_head
 200                      || get_tree_entry(head->hash, name, oid.hash, &mode)
 201                      || ce->ce_mode != create_ce_mode(mode)
 202                      || oidcmp(&ce->oid, &oid))
 203                         staged_changes = 1;
 204
 205                 /*
 206                  * If the index does not match the file in the work
 207                  * tree and if it does not match the HEAD commit
 208                  * either, (1) "git rm" without --cached definitely
 209                  * will lose information; (2) "git rm --cached" will
 210                  * lose information unless it is about removing an
 211                  * "intent to add" entry.
 212                  */
 213                 if (local_changes && staged_changes) {
 214                         if (!index_only || !ce_intent_to_add(ce))
 215                                 string_list_append(&files_staged, name);
 216                 }
 217                 else if (!index_only) {
 218                         if (staged_changes)
 219                                 string_list_append(&files_cached, name);
 220                         if (local_changes) {
 221                                 if (S_ISGITLINK(ce->ce_mode) &&
 222                                     !submodule_uses_gitfile(name))
 223                                         string_list_append(&files_submodule, name);
 224                                 else
 225                                         string_list_append(&files_local, name);
 226                         }
 227                 }
 228         }
 229         print_error_files(&files_staged,
 230                           Q_("the following file has staged content different "
 231                              "from both the\nfile and the HEAD:",
 232                              "the following files have staged content different"
 233                              " from both the\nfile and the HEAD:",
 234                              files_staged.nr),
 235                           _("\n(use -f to force removal)"),
 236                           &errs);
 237         string_list_clear(&files_staged, 0);
 238         print_error_files(&files_cached,
 239                           Q_("the following file has changes "
 240                              "staged in the index:",
 241                              "the following files have changes "
 242                              "staged in the index:", files_cached.nr),
 243                           _("\n(use --cached to keep the file,"
 244                             " or -f to force removal)"),
 245                           &errs);
 246         string_list_clear(&files_cached, 0);
 247
 248         error_removing_concrete_submodules(&files_submodule, &errs);
 249
 250         print_error_files(&files_local,
 251                           Q_("the following file has local modifications:",
 252                              "the following files have local modifications:",
 253                              files_local.nr),
 254                           _("\n(use --cached to keep the file,"
 255                             " or -f to force removal)"),
 256                           &errs);
 257         string_list_clear(&files_local, 0);
 258
 259         return errs;
 260 }
 261
 262 static struct lock_file lock_file;
 263
 264 static int show_only = 0, force = 0, index_only = 0, recursive = 0, quiet = 0;
 265 static int ignore_unmatch = 0;
 266
 267 static struct option builtin_rm_options[] = {
 268         OPT__DRY_RUN(&show_only, N_("dry run")),
 269         OPT__QUIET(&quiet, N_("do not list removed files")),
 270         OPT_BOOL( 0 , "cached",         &index_only, N_("only remove from the index")),
 271         OPT__FORCE(&force, N_("override the up-to-date check")),
 272         OPT_BOOL('r', NULL,             &recursive,  N_("allow recursive removal")),
 273         OPT_BOOL( 0 , "ignore-unmatch", &ignore_unmatch,
 274                                 N_("exit with a zero status even if nothing matched")),
 275         OPT_END(),
 276 };
 277
 278 int cmd_rm(int argc, const char **argv, const char *prefix)
 279 {
 280         int i;
 281         struct pathspec pathspec;
 282         char *seen;
 283
 284         gitmodules_config();
 285         git_config(git_default_config, NULL);
 286
 287         argc = parse_options(argc, argv, prefix, builtin_rm_options,
 288                              builtin_rm_usage, 0);
 289         if (!argc)
 290                 usage_with_options(builtin_rm_usage, builtin_rm_options);
 291
 292         if (!index_only)
 293                 setup_work_tree();
 294
 295         hold_locked_index(&lock_file, 1);
 296
 297         if (read_cache() < 0)
 298                 die(_("index file corrupt"));
 299
 300         parse_pathspec(&pathspec, 0,
 301                        PATHSPEC_PREFER_CWD |
 302                        PATHSPEC_STRIP_SUBMODULE_SLASH_CHEAP,
 303                        prefix, argv);
 304         refresh_index(&the_index, REFRESH_QUIET, &pathspec, NULL, NULL);
 305
 306         seen = xcalloc(pathspec.nr, 1);
 307
 308         for (i = 0; i < active_nr; i++) {
 309                 const struct cache_entry *ce = active_cache[i];
 310                 if (!ce_path_match(ce, &pathspec, seen))
 311                         continue;
 312                 ALLOC_GROW(list.entry, list.nr + 1, list.alloc);
 313                 list.entry[list.nr].name = xstrdup(ce->name);
 314                 list.entry[list.nr].is_submodule = S_ISGITLINK(ce->ce_mode);
 315                 if (list.entry[list.nr++].is_submodule &&
 316                     !is_staging_gitmodules_ok())
 317                         die (_("Please stage your changes to .gitmodules or stash them to proceed"));
 318         }
 319
 320         if (pathspec.nr) {
 321                 const char *original;
 322                 int seen_any = 0;
 323                 for (i = 0; i < pathspec.nr; i++) {
 324                         original = pathspec.items[i].original;
 325                         if (!seen[i]) {
 326                                 if (!ignore_unmatch) {
 327                                         die(_("pathspec '%s' did not match any files"),
 328                                             original);
 329                                 }
 330                         }
 331                         else {
 332                                 seen_any = 1;
 333                         }
 334                         if (!recursive && seen[i] == MATCHED_RECURSIVELY)
 335                                 die(_("not removing '%s' recursively without -r"),
 336                                     *original ? original : ".");
 337                 }
 338
 339                 if (!seen_any)
 340                         exit(0);
 341         }
 342
 343         /*
 344          * If not forced, the file, the index and the HEAD (if exists)
 345          * must match; but the file can already been removed, since
 346          * this sequence is a natural "novice" way:
 347          *
 348          *      rm F; git rm F
 349          *
 350          * Further, if HEAD commit exists, "diff-index --cached" must
 351          * report no changes unless forced.
 352          */
 353         if (!force) {
 354                 struct object_id oid;
 355                 if (get_oid("HEAD", &oid))
 356                         oidclr(&oid);
 357                 if (check_local_mod(&oid, index_only))
 358                         exit(1);
 359         } else if (!index_only) {
 360                 if (check_submodules_use_gitfiles())
 361                         exit(1);
 362         }
 363
 364         /*
 365          * First remove the names from the index: we won't commit
 366          * the index unless all of them succeed.
 367          */
 368         for (i = 0; i < list.nr; i++) {
 369                 const char *path = list.entry[i].name;
 370                 if (!quiet)
 371                         printf("rm '%s'\n", path);
 372
 373                 if (remove_file_from_cache(path))
 374                         die(_("git rm: unable to remove %s"), path);
 375         }
 376
 377         if (show_only)
 378                 return 0;
 379
 380         /*
 381          * Then, unless we used "--cached", remove the filenames from
 382          * the workspace. If we fail to remove the first one, we
 383          * abort the "git rm" (but once we've successfully removed
 384          * any file at all, we'll go ahead and commit to it all:
 385          * by then we've already committed ourselves and can't fail
 386          * in the middle)
 387          */
 388         if (!index_only) {
 389                 int removed = 0, gitmodules_modified = 0;
 390                 struct strbuf buf = STRBUF_INIT;
 391                 for (i = 0; i < list.nr; i++) {
 392                         const char *path = list.entry[i].name;
 393                         if (list.entry[i].is_submodule) {
 394                                 if (is_empty_dir(path)) {
 395                                         if (!rmdir(path)) {
 396                                                 removed = 1;
 397                                                 if (!remove_path_from_gitmodules(path))
 398                                                         gitmodules_modified = 1;
 399                                                 continue;
 400                                         }
 401                                 } else {
 402                                         strbuf_reset(&buf);
 403                                         strbuf_addstr(&buf, path);
 404                                         if (!remove_dir_recursively(&buf, 0)) {
 405                                                 removed = 1;
 406                                                 if (!remove_path_from_gitmodules(path))
 407                                                         gitmodules_modified = 1;
 408                                                 strbuf_release(&buf);
 409                                                 continue;
 410                                         } else if (!file_exists(path))
 411                                                 /* Submodule was removed by user */
 412                                                 if (!remove_path_from_gitmodules(path))
 413                                                         gitmodules_modified = 1;
 414                                         /* Fallthrough and let remove_path() fail. */
 415                                 }
 416                         }
 417                         if (!remove_path(path)) {
 418                                 removed = 1;
 419                                 continue;
 420                         }
 421                         if (!removed)
 422                                 die_errno("git rm: '%s'", path);
 423                 }
 424                 strbuf_release(&buf);
 425                 if (gitmodules_modified)
 426                         stage_updated_gitmodules();
 427         }
 428
 429         if (active_cache_changed) {
 430                 if (write_locked_index(&the_index, &lock_file, COMMIT_LOCK))
 431                         die(_("Unable to write new index file"));
 432         }
 433
 434         return 0;
 435 }