Documentation: Correct synopsis for git-add command
[git/jnareb-git.git] / builtin-fsck.c
blob44ce629a498f986f239e008a61d32e10968907e0
1 #include "cache.h"
2 #include "commit.h"
3 #include "tree.h"
4 #include "blob.h"
5 #include "tag.h"
6 #include "refs.h"
7 #include "pack.h"
8 #include "cache-tree.h"
9 #include "tree-walk.h"
11 #define REACHABLE 0x0001
12 #define SEEN 0x0002
14 static int show_root;
15 static int show_tags;
16 static int show_unreachable;
17 static int include_reflogs = 1;
18 static int check_full;
19 static int check_strict;
20 static int keep_cache_objects;
21 static unsigned char head_sha1[20];
22 static int errors_found;
23 #define ERROR_OBJECT 01
24 #define ERROR_REACHABLE 02
26 #ifdef NO_D_INO_IN_DIRENT
27 #define SORT_DIRENT 0
28 #define DIRENT_SORT_HINT(de) 0
29 #else
30 #define SORT_DIRENT 1
31 #define DIRENT_SORT_HINT(de) ((de)->d_ino)
32 #endif
34 static void objreport(struct object *obj, const char *severity,
35 const char *err, va_list params)
37 fprintf(stderr, "%s in %s %s: ",
38 severity, typename(obj->type), sha1_to_hex(obj->sha1));
39 vfprintf(stderr, err, params);
40 fputs("\n", stderr);
43 static int objerror(struct object *obj, const char *err, ...)
45 va_list params;
46 va_start(params, err);
47 errors_found |= ERROR_OBJECT;
48 objreport(obj, "error", err, params);
49 va_end(params);
50 return -1;
53 static int objwarning(struct object *obj, const char *err, ...)
55 va_list params;
56 va_start(params, err);
57 objreport(obj, "warning", err, params);
58 va_end(params);
59 return -1;
63 * Check a single reachable object
65 static void check_reachable_object(struct object *obj)
67 const struct object_refs *refs;
70 * We obviously want the object to be parsed,
71 * except if it was in a pack-file and we didn't
72 * do a full fsck
74 if (!obj->parsed) {
75 if (has_sha1_pack(obj->sha1, NULL))
76 return; /* it is in pack - forget about it */
77 printf("missing %s %s\n", typename(obj->type), sha1_to_hex(obj->sha1));
78 errors_found |= ERROR_REACHABLE;
79 return;
83 * Check that everything that we try to reference is also good.
85 refs = lookup_object_refs(obj);
86 if (refs) {
87 unsigned j;
88 for (j = 0; j < refs->count; j++) {
89 struct object *ref = refs->ref[j];
90 if (ref->parsed ||
91 (has_sha1_file(ref->sha1)))
92 continue;
93 printf("broken link from %7s %s\n",
94 typename(obj->type), sha1_to_hex(obj->sha1));
95 printf(" to %7s %s\n",
96 typename(ref->type), sha1_to_hex(ref->sha1));
97 errors_found |= ERROR_REACHABLE;
103 * Check a single unreachable object
105 static void check_unreachable_object(struct object *obj)
108 * Missing unreachable object? Ignore it. It's not like
109 * we miss it (since it can't be reached), nor do we want
110 * to complain about it being unreachable (since it does
111 * not exist).
113 if (!obj->parsed)
114 return;
117 * Unreachable object that exists? Show it if asked to,
118 * since this is something that is prunable.
120 if (show_unreachable) {
121 printf("unreachable %s %s\n", typename(obj->type), sha1_to_hex(obj->sha1));
122 return;
126 * "!used" means that nothing at all points to it, including
127 * other unreachable objects. In other words, it's the "tip"
128 * of some set of unreachable objects, usually a commit that
129 * got dropped.
131 * Such starting points are more interesting than some random
132 * set of unreachable objects, so we show them even if the user
133 * hasn't asked for _all_ unreachable objects. If you have
134 * deleted a branch by mistake, this is a prime candidate to
135 * start looking at, for example.
137 if (!obj->used) {
138 printf("dangling %s %s\n", typename(obj->type),
139 sha1_to_hex(obj->sha1));
140 return;
144 * Otherwise? It's there, it's unreachable, and some other unreachable
145 * object points to it. Ignore it - it's not interesting, and we showed
146 * all the interesting cases above.
150 static void check_object(struct object *obj)
152 if (obj->flags & REACHABLE)
153 check_reachable_object(obj);
154 else
155 check_unreachable_object(obj);
158 static void check_connectivity(void)
160 int i, max;
162 /* Look up all the requirements, warn about missing objects.. */
163 max = get_max_object_index();
164 for (i = 0; i < max; i++) {
165 struct object *obj = get_indexed_object(i);
167 if (obj)
168 check_object(obj);
173 * The entries in a tree are ordered in the _path_ order,
174 * which means that a directory entry is ordered by adding
175 * a slash to the end of it.
177 * So a directory called "a" is ordered _after_ a file
178 * called "a.c", because "a/" sorts after "a.c".
180 #define TREE_UNORDERED (-1)
181 #define TREE_HAS_DUPS (-2)
183 static int verify_ordered(unsigned mode1, const char *name1, unsigned mode2, const char *name2)
185 int len1 = strlen(name1);
186 int len2 = strlen(name2);
187 int len = len1 < len2 ? len1 : len2;
188 unsigned char c1, c2;
189 int cmp;
191 cmp = memcmp(name1, name2, len);
192 if (cmp < 0)
193 return 0;
194 if (cmp > 0)
195 return TREE_UNORDERED;
198 * Ok, the first <len> characters are the same.
199 * Now we need to order the next one, but turn
200 * a '\0' into a '/' for a directory entry.
202 c1 = name1[len];
203 c2 = name2[len];
204 if (!c1 && !c2)
206 * git-write-tree used to write out a nonsense tree that has
207 * entries with the same name, one blob and one tree. Make
208 * sure we do not have duplicate entries.
210 return TREE_HAS_DUPS;
211 if (!c1 && S_ISDIR(mode1))
212 c1 = '/';
213 if (!c2 && S_ISDIR(mode2))
214 c2 = '/';
215 return c1 < c2 ? 0 : TREE_UNORDERED;
218 static int fsck_tree(struct tree *item)
220 int retval;
221 int has_full_path = 0;
222 int has_empty_name = 0;
223 int has_zero_pad = 0;
224 int has_bad_modes = 0;
225 int has_dup_entries = 0;
226 int not_properly_sorted = 0;
227 struct tree_desc desc;
228 unsigned o_mode;
229 const char *o_name;
230 const unsigned char *o_sha1;
232 init_tree_desc(&desc, item->buffer, item->size);
234 o_mode = 0;
235 o_name = NULL;
236 o_sha1 = NULL;
237 while (desc.size) {
238 unsigned mode;
239 const char *name;
240 const unsigned char *sha1;
242 sha1 = tree_entry_extract(&desc, &name, &mode);
244 if (strchr(name, '/'))
245 has_full_path = 1;
246 if (!*name)
247 has_empty_name = 1;
248 has_zero_pad |= *(char *)desc.buffer == '0';
249 update_tree_entry(&desc);
251 switch (mode) {
253 * Standard modes..
255 case S_IFREG | 0755:
256 case S_IFREG | 0644:
257 case S_IFLNK:
258 case S_IFDIR:
259 case S_IFDIRLNK:
260 break;
262 * This is nonstandard, but we had a few of these
263 * early on when we honored the full set of mode
264 * bits..
266 case S_IFREG | 0664:
267 if (!check_strict)
268 break;
269 default:
270 has_bad_modes = 1;
273 if (o_name) {
274 switch (verify_ordered(o_mode, o_name, mode, name)) {
275 case TREE_UNORDERED:
276 not_properly_sorted = 1;
277 break;
278 case TREE_HAS_DUPS:
279 has_dup_entries = 1;
280 break;
281 default:
282 break;
286 o_mode = mode;
287 o_name = name;
288 o_sha1 = sha1;
290 free(item->buffer);
291 item->buffer = NULL;
293 retval = 0;
294 if (has_full_path) {
295 objwarning(&item->object, "contains full pathnames");
297 if (has_empty_name) {
298 objwarning(&item->object, "contains empty pathname");
300 if (has_zero_pad) {
301 objwarning(&item->object, "contains zero-padded file modes");
303 if (has_bad_modes) {
304 objwarning(&item->object, "contains bad file modes");
306 if (has_dup_entries) {
307 retval = objerror(&item->object, "contains duplicate file entries");
309 if (not_properly_sorted) {
310 retval = objerror(&item->object, "not properly sorted");
312 return retval;
315 static int fsck_commit(struct commit *commit)
317 char *buffer = commit->buffer;
318 unsigned char tree_sha1[20], sha1[20];
320 if (memcmp(buffer, "tree ", 5))
321 return objerror(&commit->object, "invalid format - expected 'tree' line");
322 if (get_sha1_hex(buffer+5, tree_sha1) || buffer[45] != '\n')
323 return objerror(&commit->object, "invalid 'tree' line format - bad sha1");
324 buffer += 46;
325 while (!memcmp(buffer, "parent ", 7)) {
326 if (get_sha1_hex(buffer+7, sha1) || buffer[47] != '\n')
327 return objerror(&commit->object, "invalid 'parent' line format - bad sha1");
328 buffer += 48;
330 if (memcmp(buffer, "author ", 7))
331 return objerror(&commit->object, "invalid format - expected 'author' line");
332 free(commit->buffer);
333 commit->buffer = NULL;
334 if (!commit->tree)
335 return objerror(&commit->object, "could not load commit's tree %s", tree_sha1);
336 if (!commit->parents && show_root)
337 printf("root %s\n", sha1_to_hex(commit->object.sha1));
338 if (!commit->date)
339 printf("bad commit date in %s\n",
340 sha1_to_hex(commit->object.sha1));
341 return 0;
344 static int fsck_tag(struct tag *tag)
346 struct object *tagged = tag->tagged;
348 if (!tagged) {
349 return objerror(&tag->object, "could not load tagged object");
351 if (!show_tags)
352 return 0;
354 printf("tagged %s %s", typename(tagged->type), sha1_to_hex(tagged->sha1));
355 printf(" (%s) in %s\n", tag->tag, sha1_to_hex(tag->object.sha1));
356 return 0;
359 static int fsck_sha1(const unsigned char *sha1)
361 struct object *obj = parse_object(sha1);
362 if (!obj) {
363 errors_found |= ERROR_OBJECT;
364 return error("%s: object corrupt or missing",
365 sha1_to_hex(sha1));
367 if (obj->flags & SEEN)
368 return 0;
369 obj->flags |= SEEN;
370 if (obj->type == OBJ_BLOB)
371 return 0;
372 if (obj->type == OBJ_TREE)
373 return fsck_tree((struct tree *) obj);
374 if (obj->type == OBJ_COMMIT)
375 return fsck_commit((struct commit *) obj);
376 if (obj->type == OBJ_TAG)
377 return fsck_tag((struct tag *) obj);
379 /* By now, parse_object() would've returned NULL instead. */
380 return objerror(obj, "unknown type '%d' (internal fsck error)",
381 obj->type);
385 * This is the sorting chunk size: make it reasonably
386 * big so that we can sort well..
388 #define MAX_SHA1_ENTRIES (1024)
390 struct sha1_entry {
391 unsigned long ino;
392 unsigned char sha1[20];
395 static struct {
396 unsigned long nr;
397 struct sha1_entry *entry[MAX_SHA1_ENTRIES];
398 } sha1_list;
400 static int ino_compare(const void *_a, const void *_b)
402 const struct sha1_entry *a = _a, *b = _b;
403 unsigned long ino1 = a->ino, ino2 = b->ino;
404 return ino1 < ino2 ? -1 : ino1 > ino2 ? 1 : 0;
407 static void fsck_sha1_list(void)
409 int i, nr = sha1_list.nr;
411 if (SORT_DIRENT)
412 qsort(sha1_list.entry, nr,
413 sizeof(struct sha1_entry *), ino_compare);
414 for (i = 0; i < nr; i++) {
415 struct sha1_entry *entry = sha1_list.entry[i];
416 unsigned char *sha1 = entry->sha1;
418 sha1_list.entry[i] = NULL;
419 fsck_sha1(sha1);
420 free(entry);
422 sha1_list.nr = 0;
425 static void add_sha1_list(unsigned char *sha1, unsigned long ino)
427 struct sha1_entry *entry = xmalloc(sizeof(*entry));
428 int nr;
430 entry->ino = ino;
431 hashcpy(entry->sha1, sha1);
432 nr = sha1_list.nr;
433 if (nr == MAX_SHA1_ENTRIES) {
434 fsck_sha1_list();
435 nr = 0;
437 sha1_list.entry[nr] = entry;
438 sha1_list.nr = ++nr;
441 static void fsck_dir(int i, char *path)
443 DIR *dir = opendir(path);
444 struct dirent *de;
446 if (!dir)
447 return;
449 while ((de = readdir(dir)) != NULL) {
450 char name[100];
451 unsigned char sha1[20];
452 int len = strlen(de->d_name);
454 switch (len) {
455 case 2:
456 if (de->d_name[1] != '.')
457 break;
458 case 1:
459 if (de->d_name[0] != '.')
460 break;
461 continue;
462 case 38:
463 sprintf(name, "%02x", i);
464 memcpy(name+2, de->d_name, len+1);
465 if (get_sha1_hex(name, sha1) < 0)
466 break;
467 add_sha1_list(sha1, DIRENT_SORT_HINT(de));
468 continue;
470 fprintf(stderr, "bad sha1 file: %s/%s\n", path, de->d_name);
472 closedir(dir);
475 static int default_refs;
477 static int fsck_handle_reflog_ent(unsigned char *osha1, unsigned char *nsha1,
478 const char *email, unsigned long timestamp, int tz,
479 const char *message, void *cb_data)
481 struct object *obj;
483 if (!is_null_sha1(osha1)) {
484 obj = lookup_object(osha1);
485 if (obj) {
486 obj->used = 1;
487 mark_reachable(obj, REACHABLE);
490 obj = lookup_object(nsha1);
491 if (obj) {
492 obj->used = 1;
493 mark_reachable(obj, REACHABLE);
495 return 0;
498 static int fsck_handle_reflog(const char *logname, const unsigned char *sha1, int flag, void *cb_data)
500 for_each_reflog_ent(logname, fsck_handle_reflog_ent, NULL);
501 return 0;
504 static int fsck_handle_ref(const char *refname, const unsigned char *sha1, int flag, void *cb_data)
506 struct object *obj;
508 obj = lookup_object(sha1);
509 if (!obj) {
510 if (has_sha1_file(sha1)) {
511 default_refs++;
512 return 0; /* it is in a pack */
514 error("%s: invalid sha1 pointer %s", refname, sha1_to_hex(sha1));
515 /* We'll continue with the rest despite the error.. */
516 return 0;
518 default_refs++;
519 obj->used = 1;
520 mark_reachable(obj, REACHABLE);
522 return 0;
525 static void get_default_heads(void)
527 for_each_ref(fsck_handle_ref, NULL);
528 if (include_reflogs)
529 for_each_reflog(fsck_handle_reflog, NULL);
532 * Not having any default heads isn't really fatal, but
533 * it does mean that "--unreachable" no longer makes any
534 * sense (since in this case everything will obviously
535 * be unreachable by definition.
537 * Showing dangling objects is valid, though (as those
538 * dangling objects are likely lost heads).
540 * So we just print a warning about it, and clear the
541 * "show_unreachable" flag.
543 if (!default_refs) {
544 fprintf(stderr, "notice: No default references\n");
545 show_unreachable = 0;
549 static void fsck_object_dir(const char *path)
551 int i;
552 for (i = 0; i < 256; i++) {
553 static char dir[4096];
554 sprintf(dir, "%s/%02x", path, i);
555 fsck_dir(i, dir);
557 fsck_sha1_list();
560 static int fsck_head_link(void)
562 unsigned char sha1[20];
563 int flag;
564 int null_is_error = 0;
565 const char *head_points_at = resolve_ref("HEAD", sha1, 0, &flag);
567 if (!head_points_at)
568 return error("Invalid HEAD");
569 if (!strcmp(head_points_at, "HEAD"))
570 /* detached HEAD */
571 null_is_error = 1;
572 else if (prefixcmp(head_points_at, "refs/heads/"))
573 return error("HEAD points to something strange (%s)",
574 head_points_at);
575 if (is_null_sha1(sha1)) {
576 if (null_is_error)
577 return error("HEAD: detached HEAD points at nothing");
578 fprintf(stderr, "notice: HEAD points to an unborn branch (%s)\n",
579 head_points_at + 11);
581 return 0;
584 static int fsck_cache_tree(struct cache_tree *it)
586 int i;
587 int err = 0;
589 if (0 <= it->entry_count) {
590 struct object *obj = parse_object(it->sha1);
591 if (!obj) {
592 error("%s: invalid sha1 pointer in cache-tree",
593 sha1_to_hex(it->sha1));
594 return 1;
596 mark_reachable(obj, REACHABLE);
597 obj->used = 1;
598 if (obj->type != OBJ_TREE)
599 err |= objerror(obj, "non-tree in cache-tree");
601 for (i = 0; i < it->subtree_nr; i++)
602 err |= fsck_cache_tree(it->down[i]->cache_tree);
603 return err;
606 static const char fsck_usage[] =
607 "git-fsck [--tags] [--root] [[--unreachable] [--cache] [--full] "
608 "[--strict] <head-sha1>*]";
610 int cmd_fsck(int argc, char **argv, const char *prefix)
612 int i, heads;
614 track_object_refs = 1;
615 errors_found = 0;
617 for (i = 1; i < argc; i++) {
618 const char *arg = argv[i];
620 if (!strcmp(arg, "--unreachable")) {
621 show_unreachable = 1;
622 continue;
624 if (!strcmp(arg, "--tags")) {
625 show_tags = 1;
626 continue;
628 if (!strcmp(arg, "--root")) {
629 show_root = 1;
630 continue;
632 if (!strcmp(arg, "--cache")) {
633 keep_cache_objects = 1;
634 continue;
636 if (!strcmp(arg, "--no-reflogs")) {
637 include_reflogs = 0;
638 continue;
640 if (!strcmp(arg, "--full")) {
641 check_full = 1;
642 continue;
644 if (!strcmp(arg, "--strict")) {
645 check_strict = 1;
646 continue;
648 if (*arg == '-')
649 usage(fsck_usage);
652 fsck_head_link();
653 fsck_object_dir(get_object_directory());
654 if (check_full) {
655 struct alternate_object_database *alt;
656 struct packed_git *p;
657 prepare_alt_odb();
658 for (alt = alt_odb_list; alt; alt = alt->next) {
659 char namebuf[PATH_MAX];
660 int namelen = alt->name - alt->base;
661 memcpy(namebuf, alt->base, namelen);
662 namebuf[namelen - 1] = 0;
663 fsck_object_dir(namebuf);
665 prepare_packed_git();
666 for (p = packed_git; p; p = p->next)
667 /* verify gives error messages itself */
668 verify_pack(p, 0);
670 for (p = packed_git; p; p = p->next) {
671 uint32_t i, num = p->num_objects;
672 for (i = 0; i < num; i++)
673 fsck_sha1(nth_packed_object_sha1(p, i));
677 heads = 0;
678 for (i = 1; i < argc; i++) {
679 const char *arg = argv[i];
681 if (*arg == '-')
682 continue;
684 if (!get_sha1(arg, head_sha1)) {
685 struct object *obj = lookup_object(head_sha1);
687 /* Error is printed by lookup_object(). */
688 if (!obj)
689 continue;
691 obj->used = 1;
692 mark_reachable(obj, REACHABLE);
693 heads++;
694 continue;
696 error("invalid parameter: expected sha1, got '%s'", arg);
700 * If we've not been given any explicit head information, do the
701 * default ones from .git/refs. We also consider the index file
702 * in this case (ie this implies --cache).
704 if (!heads) {
705 get_default_heads();
706 keep_cache_objects = 1;
709 if (keep_cache_objects) {
710 int i;
711 read_cache();
712 for (i = 0; i < active_nr; i++) {
713 unsigned int mode;
714 struct blob *blob;
715 struct object *obj;
717 mode = ntohl(active_cache[i]->ce_mode);
718 if (S_ISDIRLNK(mode))
719 continue;
720 blob = lookup_blob(active_cache[i]->sha1);
721 if (!blob)
722 continue;
723 obj = &blob->object;
724 obj->used = 1;
725 mark_reachable(obj, REACHABLE);
727 if (active_cache_tree)
728 fsck_cache_tree(active_cache_tree);
731 check_connectivity();
732 return errors_found;