doc: rewrite description for rev-parse --short
[git/git-svn.git] / builtin / rm.c
blobfb79dcab181558e79e3934363cac3c712ffbd3aa
1 /*
2 * "git rm" builtin command
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"
16 static const char * const builtin_rm_usage[] = {
17 N_("git rm [<options>] [--] <file>..."),
18 NULL
21 static struct {
22 int nr, alloc;
23 struct {
24 const char *name;
25 char is_submodule;
26 } *entry;
27 } list;
29 static int get_ours_cache_pos(const char *path, int pos)
31 int i = -pos - 1;
33 while ((i < active_nr) && !strcmp(active_cache[i]->name, path)) {
34 if (ce_stage(active_cache[i]) == 2)
35 return i;
36 i++;
38 return -1;
41 static void print_error_files(struct string_list *files_list,
42 const char *main_msg,
43 const char *hints_msg,
44 int *errs)
46 if (files_list->nr) {
47 int i;
48 struct strbuf err_msg = STRBUF_INIT;
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);
62 static void submodules_absorb_gitdir_if_needed(const char *prefix)
64 int i;
65 for (i = 0; i < list.nr; i++) {
66 const char *name = list.entry[i].name;
67 int pos;
68 const struct cache_entry *ce;
70 pos = cache_name_pos(name, strlen(name));
71 if (pos < 0) {
72 pos = get_ours_cache_pos(name, pos);
73 if (pos < 0)
74 continue;
76 ce = active_cache[pos];
78 if (!S_ISGITLINK(ce->ce_mode) ||
79 !file_exists(ce->name) ||
80 is_empty_dir(name))
81 continue;
83 if (!submodule_uses_gitfile(name))
84 absorb_git_dir_into_superproject(prefix, name,
85 ABSORB_GITDIR_RECURSE_SUBMODULES);
89 static int check_local_mod(struct object_id *head, int index_only)
92 * Items in list are already sorted in the cache order,
93 * so we could do this a lot more efficiently by using
94 * tree_desc based traversal if we wanted to, but I am
95 * lazy, and who cares if removal of files is a tad
96 * slower than the theoretical maximum speed?
98 int i, no_head;
99 int errs = 0;
100 struct string_list files_staged = STRING_LIST_INIT_NODUP;
101 struct string_list files_cached = STRING_LIST_INIT_NODUP;
102 struct string_list files_local = STRING_LIST_INIT_NODUP;
104 no_head = is_null_oid(head);
105 for (i = 0; i < list.nr; i++) {
106 struct stat st;
107 int pos;
108 const struct cache_entry *ce;
109 const char *name = list.entry[i].name;
110 struct object_id oid;
111 unsigned mode;
112 int local_changes = 0;
113 int staged_changes = 0;
115 pos = cache_name_pos(name, strlen(name));
116 if (pos < 0) {
118 * Skip unmerged entries except for populated submodules
119 * that could lose history when removed.
121 pos = get_ours_cache_pos(name, pos);
122 if (pos < 0)
123 continue;
125 if (!S_ISGITLINK(active_cache[pos]->ce_mode) ||
126 is_empty_dir(name))
127 continue;
129 ce = active_cache[pos];
131 if (lstat(ce->name, &st) < 0) {
132 if (errno != ENOENT && errno != ENOTDIR)
133 warning_errno(_("failed to stat '%s'"), ce->name);
134 /* It already vanished from the working tree */
135 continue;
137 else if (S_ISDIR(st.st_mode)) {
138 /* if a file was removed and it is now a
139 * directory, that is the same as ENOENT as
140 * far as git is concerned; we do not track
141 * directories unless they are submodules.
143 if (!S_ISGITLINK(ce->ce_mode))
144 continue;
148 * "rm" of a path that has changes need to be treated
149 * carefully not to allow losing local changes
150 * accidentally. A local change could be (1) file in
151 * work tree is different since the index; and/or (2)
152 * the user staged a content that is different from
153 * the current commit in the index.
155 * In such a case, you would need to --force the
156 * removal. However, "rm --cached" (remove only from
157 * the index) is safe if the index matches the file in
158 * the work tree or the HEAD commit, as it means that
159 * the content being removed is available elsewhere.
163 * Is the index different from the file in the work tree?
164 * If it's a submodule, is its work tree modified?
166 if (ce_match_stat(ce, &st, 0) ||
167 (S_ISGITLINK(ce->ce_mode) &&
168 bad_to_remove_submodule(ce->name,
169 SUBMODULE_REMOVAL_DIE_ON_ERROR |
170 SUBMODULE_REMOVAL_IGNORE_IGNORED_UNTRACKED)))
171 local_changes = 1;
174 * Is the index different from the HEAD commit? By
175 * definition, before the very initial commit,
176 * anything staged in the index is treated by the same
177 * way as changed from the HEAD.
179 if (no_head
180 || get_tree_entry(head->hash, name, oid.hash, &mode)
181 || ce->ce_mode != create_ce_mode(mode)
182 || oidcmp(&ce->oid, &oid))
183 staged_changes = 1;
186 * If the index does not match the file in the work
187 * tree and if it does not match the HEAD commit
188 * either, (1) "git rm" without --cached definitely
189 * will lose information; (2) "git rm --cached" will
190 * lose information unless it is about removing an
191 * "intent to add" entry.
193 if (local_changes && staged_changes) {
194 if (!index_only || !ce_intent_to_add(ce))
195 string_list_append(&files_staged, name);
197 else if (!index_only) {
198 if (staged_changes)
199 string_list_append(&files_cached, name);
200 if (local_changes)
201 string_list_append(&files_local, name);
204 print_error_files(&files_staged,
205 Q_("the following file has staged content different "
206 "from both the\nfile and the HEAD:",
207 "the following files have staged content different"
208 " from both the\nfile and the HEAD:",
209 files_staged.nr),
210 _("\n(use -f to force removal)"),
211 &errs);
212 string_list_clear(&files_staged, 0);
213 print_error_files(&files_cached,
214 Q_("the following file has changes "
215 "staged in the index:",
216 "the following files have changes "
217 "staged in the index:", files_cached.nr),
218 _("\n(use --cached to keep the file,"
219 " or -f to force removal)"),
220 &errs);
221 string_list_clear(&files_cached, 0);
223 print_error_files(&files_local,
224 Q_("the following file has local modifications:",
225 "the following files have local modifications:",
226 files_local.nr),
227 _("\n(use --cached to keep the file,"
228 " or -f to force removal)"),
229 &errs);
230 string_list_clear(&files_local, 0);
232 return errs;
235 static struct lock_file lock_file;
237 static int show_only = 0, force = 0, index_only = 0, recursive = 0, quiet = 0;
238 static int ignore_unmatch = 0;
240 static struct option builtin_rm_options[] = {
241 OPT__DRY_RUN(&show_only, N_("dry run")),
242 OPT__QUIET(&quiet, N_("do not list removed files")),
243 OPT_BOOL( 0 , "cached", &index_only, N_("only remove from the index")),
244 OPT__FORCE(&force, N_("override the up-to-date check")),
245 OPT_BOOL('r', NULL, &recursive, N_("allow recursive removal")),
246 OPT_BOOL( 0 , "ignore-unmatch", &ignore_unmatch,
247 N_("exit with a zero status even if nothing matched")),
248 OPT_END(),
251 int cmd_rm(int argc, const char **argv, const char *prefix)
253 int i;
254 struct pathspec pathspec;
255 char *seen;
257 gitmodules_config();
258 git_config(git_default_config, NULL);
260 argc = parse_options(argc, argv, prefix, builtin_rm_options,
261 builtin_rm_usage, 0);
262 if (!argc)
263 usage_with_options(builtin_rm_usage, builtin_rm_options);
265 if (!index_only)
266 setup_work_tree();
268 hold_locked_index(&lock_file, LOCK_DIE_ON_ERROR);
270 if (read_cache() < 0)
271 die(_("index file corrupt"));
273 parse_pathspec(&pathspec, 0,
274 PATHSPEC_PREFER_CWD |
275 PATHSPEC_STRIP_SUBMODULE_SLASH_CHEAP,
276 prefix, argv);
277 refresh_index(&the_index, REFRESH_QUIET, &pathspec, NULL, NULL);
279 seen = xcalloc(pathspec.nr, 1);
281 for (i = 0; i < active_nr; i++) {
282 const struct cache_entry *ce = active_cache[i];
283 if (!ce_path_match(ce, &pathspec, seen))
284 continue;
285 ALLOC_GROW(list.entry, list.nr + 1, list.alloc);
286 list.entry[list.nr].name = xstrdup(ce->name);
287 list.entry[list.nr].is_submodule = S_ISGITLINK(ce->ce_mode);
288 if (list.entry[list.nr++].is_submodule &&
289 !is_staging_gitmodules_ok())
290 die (_("Please stage your changes to .gitmodules or stash them to proceed"));
293 if (pathspec.nr) {
294 const char *original;
295 int seen_any = 0;
296 for (i = 0; i < pathspec.nr; i++) {
297 original = pathspec.items[i].original;
298 if (!seen[i]) {
299 if (!ignore_unmatch) {
300 die(_("pathspec '%s' did not match any files"),
301 original);
304 else {
305 seen_any = 1;
307 if (!recursive && seen[i] == MATCHED_RECURSIVELY)
308 die(_("not removing '%s' recursively without -r"),
309 *original ? original : ".");
312 if (!seen_any)
313 exit(0);
316 if (!index_only)
317 submodules_absorb_gitdir_if_needed(prefix);
320 * If not forced, the file, the index and the HEAD (if exists)
321 * must match; but the file can already been removed, since
322 * this sequence is a natural "novice" way:
324 * rm F; git rm F
326 * Further, if HEAD commit exists, "diff-index --cached" must
327 * report no changes unless forced.
329 if (!force) {
330 struct object_id oid;
331 if (get_oid("HEAD", &oid))
332 oidclr(&oid);
333 if (check_local_mod(&oid, index_only))
334 exit(1);
338 * First remove the names from the index: we won't commit
339 * the index unless all of them succeed.
341 for (i = 0; i < list.nr; i++) {
342 const char *path = list.entry[i].name;
343 if (!quiet)
344 printf("rm '%s'\n", path);
346 if (remove_file_from_cache(path))
347 die(_("git rm: unable to remove %s"), path);
350 if (show_only)
351 return 0;
354 * Then, unless we used "--cached", remove the filenames from
355 * the workspace. If we fail to remove the first one, we
356 * abort the "git rm" (but once we've successfully removed
357 * any file at all, we'll go ahead and commit to it all:
358 * by then we've already committed ourselves and can't fail
359 * in the middle)
361 if (!index_only) {
362 int removed = 0, gitmodules_modified = 0;
363 struct strbuf buf = STRBUF_INIT;
364 for (i = 0; i < list.nr; i++) {
365 const char *path = list.entry[i].name;
366 if (list.entry[i].is_submodule) {
367 strbuf_reset(&buf);
368 strbuf_addstr(&buf, path);
369 if (remove_dir_recursively(&buf, 0))
370 die(_("could not remove '%s'"), path);
372 removed = 1;
373 if (!remove_path_from_gitmodules(path))
374 gitmodules_modified = 1;
375 continue;
377 if (!remove_path(path)) {
378 removed = 1;
379 continue;
381 if (!removed)
382 die_errno("git rm: '%s'", path);
384 strbuf_release(&buf);
385 if (gitmodules_modified)
386 stage_updated_gitmodules();
389 if (active_cache_changed) {
390 if (write_locked_index(&the_index, &lock_file, COMMIT_LOCK))
391 die(_("Unable to write new index file"));
394 return 0;