git-am: Clean up the asciidoc documentation
[git/gitweb.git] / builtin-fsck.c
blob75e10e25ecdee18b226fe434c270d5660eb5d74b
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 check_full;
18 static int check_strict;
19 static int keep_cache_objects;
20 static unsigned char head_sha1[20];
21 static int errors_found;
22 #define ERROR_OBJECT 01
23 #define ERROR_REACHABLE 02
25 #ifdef NO_D_INO_IN_DIRENT
26 #define SORT_DIRENT 0
27 #define DIRENT_SORT_HINT(de) 0
28 #else
29 #define SORT_DIRENT 1
30 #define DIRENT_SORT_HINT(de) ((de)->d_ino)
31 #endif
33 static void objreport(struct object *obj, const char *severity,
34 const char *err, va_list params)
36 fprintf(stderr, "%s in %s %s: ",
37 severity, typename(obj->type), sha1_to_hex(obj->sha1));
38 vfprintf(stderr, err, params);
39 fputs("\n", stderr);
42 static int objerror(struct object *obj, const char *err, ...)
44 va_list params;
45 va_start(params, err);
46 errors_found |= ERROR_OBJECT;
47 objreport(obj, "error", err, params);
48 va_end(params);
49 return -1;
52 static int objwarning(struct object *obj, const char *err, ...)
54 va_list params;
55 va_start(params, err);
56 objreport(obj, "warning", err, params);
57 va_end(params);
58 return -1;
62 * Check a single reachable object
64 static void check_reachable_object(struct object *obj)
66 const struct object_refs *refs;
69 * We obviously want the object to be parsed,
70 * except if it was in a pack-file and we didn't
71 * do a full fsck
73 if (!obj->parsed) {
74 if (has_sha1_pack(obj->sha1, NULL))
75 return; /* it is in pack - forget about it */
76 printf("missing %s %s\n", typename(obj->type), sha1_to_hex(obj->sha1));
77 errors_found |= ERROR_REACHABLE;
78 return;
82 * Check that everything that we try to reference is also good.
84 refs = lookup_object_refs(obj);
85 if (refs) {
86 unsigned j;
87 for (j = 0; j < refs->count; j++) {
88 struct object *ref = refs->ref[j];
89 if (ref->parsed ||
90 (has_sha1_file(ref->sha1)))
91 continue;
92 printf("broken link from %7s %s\n",
93 typename(obj->type), sha1_to_hex(obj->sha1));
94 printf(" to %7s %s\n",
95 typename(ref->type), sha1_to_hex(ref->sha1));
96 errors_found |= ERROR_REACHABLE;
102 * Check a single unreachable object
104 static void check_unreachable_object(struct object *obj)
107 * Missing unreachable object? Ignore it. It's not like
108 * we miss it (since it can't be reached), nor do we want
109 * to complain about it being unreachable (since it does
110 * not exist).
112 if (!obj->parsed)
113 return;
116 * Unreachable object that exists? Show it if asked to,
117 * since this is something that is prunable.
119 if (show_unreachable) {
120 printf("unreachable %s %s\n", typename(obj->type), sha1_to_hex(obj->sha1));
121 return;
125 * "!used" means that nothing at all points to it, including
126 * other unreachable objects. In other words, it's the "tip"
127 * of some set of unreachable objects, usually a commit that
128 * got dropped.
130 * Such starting points are more interesting than some random
131 * set of unreachable objects, so we show them even if the user
132 * hasn't asked for _all_ unreachable objects. If you have
133 * deleted a branch by mistake, this is a prime candidate to
134 * start looking at, for example.
136 if (!obj->used) {
137 printf("dangling %s %s\n", typename(obj->type),
138 sha1_to_hex(obj->sha1));
139 return;
143 * Otherwise? It's there, it's unreachable, and some other unreachable
144 * object points to it. Ignore it - it's not interesting, and we showed
145 * all the interesting cases above.
149 static void check_object(struct object *obj)
151 if (obj->flags & REACHABLE)
152 check_reachable_object(obj);
153 else
154 check_unreachable_object(obj);
157 static void check_connectivity(void)
159 int i, max;
161 /* Look up all the requirements, warn about missing objects.. */
162 max = get_max_object_index();
163 for (i = 0; i < max; i++) {
164 struct object *obj = get_indexed_object(i);
166 if (obj)
167 check_object(obj);
172 * The entries in a tree are ordered in the _path_ order,
173 * which means that a directory entry is ordered by adding
174 * a slash to the end of it.
176 * So a directory called "a" is ordered _after_ a file
177 * called "a.c", because "a/" sorts after "a.c".
179 #define TREE_UNORDERED (-1)
180 #define TREE_HAS_DUPS (-2)
182 static int verify_ordered(unsigned mode1, const char *name1, unsigned mode2, const char *name2)
184 int len1 = strlen(name1);
185 int len2 = strlen(name2);
186 int len = len1 < len2 ? len1 : len2;
187 unsigned char c1, c2;
188 int cmp;
190 cmp = memcmp(name1, name2, len);
191 if (cmp < 0)
192 return 0;
193 if (cmp > 0)
194 return TREE_UNORDERED;
197 * Ok, the first <len> characters are the same.
198 * Now we need to order the next one, but turn
199 * a '\0' into a '/' for a directory entry.
201 c1 = name1[len];
202 c2 = name2[len];
203 if (!c1 && !c2)
205 * git-write-tree used to write out a nonsense tree that has
206 * entries with the same name, one blob and one tree. Make
207 * sure we do not have duplicate entries.
209 return TREE_HAS_DUPS;
210 if (!c1 && S_ISDIR(mode1))
211 c1 = '/';
212 if (!c2 && S_ISDIR(mode2))
213 c2 = '/';
214 return c1 < c2 ? 0 : TREE_UNORDERED;
217 static int fsck_tree(struct tree *item)
219 int retval;
220 int has_full_path = 0;
221 int has_empty_name = 0;
222 int has_zero_pad = 0;
223 int has_bad_modes = 0;
224 int has_dup_entries = 0;
225 int not_properly_sorted = 0;
226 struct tree_desc desc;
227 unsigned o_mode;
228 const char *o_name;
229 const unsigned char *o_sha1;
231 init_tree_desc(&desc, item->buffer, item->size);
233 o_mode = 0;
234 o_name = NULL;
235 o_sha1 = NULL;
236 while (desc.size) {
237 unsigned mode;
238 const char *name;
239 const unsigned char *sha1;
241 sha1 = tree_entry_extract(&desc, &name, &mode);
243 if (strchr(name, '/'))
244 has_full_path = 1;
245 if (!*name)
246 has_empty_name = 1;
247 has_zero_pad |= *(char *)desc.buffer == '0';
248 update_tree_entry(&desc);
250 switch (mode) {
252 * Standard modes..
254 case S_IFREG | 0755:
255 case S_IFREG | 0644:
256 case S_IFLNK:
257 case S_IFDIR:
258 break;
260 * This is nonstandard, but we had a few of these
261 * early on when we honored the full set of mode
262 * bits..
264 case S_IFREG | 0664:
265 if (!check_strict)
266 break;
267 default:
268 has_bad_modes = 1;
271 if (o_name) {
272 switch (verify_ordered(o_mode, o_name, mode, name)) {
273 case TREE_UNORDERED:
274 not_properly_sorted = 1;
275 break;
276 case TREE_HAS_DUPS:
277 has_dup_entries = 1;
278 break;
279 default:
280 break;
284 o_mode = mode;
285 o_name = name;
286 o_sha1 = sha1;
288 free(item->buffer);
289 item->buffer = NULL;
291 retval = 0;
292 if (has_full_path) {
293 objwarning(&item->object, "contains full pathnames");
295 if (has_empty_name) {
296 objwarning(&item->object, "contains empty pathname");
298 if (has_zero_pad) {
299 objwarning(&item->object, "contains zero-padded file modes");
301 if (has_bad_modes) {
302 objwarning(&item->object, "contains bad file modes");
304 if (has_dup_entries) {
305 retval = objerror(&item->object, "contains duplicate file entries");
307 if (not_properly_sorted) {
308 retval = objerror(&item->object, "not properly sorted");
310 return retval;
313 static int fsck_commit(struct commit *commit)
315 char *buffer = commit->buffer;
316 unsigned char tree_sha1[20], sha1[20];
318 if (memcmp(buffer, "tree ", 5))
319 return objerror(&commit->object, "invalid format - expected 'tree' line");
320 if (get_sha1_hex(buffer+5, tree_sha1) || buffer[45] != '\n')
321 return objerror(&commit->object, "invalid 'tree' line format - bad sha1");
322 buffer += 46;
323 while (!memcmp(buffer, "parent ", 7)) {
324 if (get_sha1_hex(buffer+7, sha1) || buffer[47] != '\n')
325 return objerror(&commit->object, "invalid 'parent' line format - bad sha1");
326 buffer += 48;
328 if (memcmp(buffer, "author ", 7))
329 return objerror(&commit->object, "invalid format - expected 'author' line");
330 free(commit->buffer);
331 commit->buffer = NULL;
332 if (!commit->tree)
333 return objerror(&commit->object, "could not load commit's tree %s", tree_sha1);
334 if (!commit->parents && show_root)
335 printf("root %s\n", sha1_to_hex(commit->object.sha1));
336 if (!commit->date)
337 printf("bad commit date in %s\n",
338 sha1_to_hex(commit->object.sha1));
339 return 0;
342 static int fsck_tag(struct tag *tag)
344 struct object *tagged = tag->tagged;
346 if (!tagged) {
347 return objerror(&tag->object, "could not load tagged object");
349 if (!show_tags)
350 return 0;
352 printf("tagged %s %s", typename(tagged->type), sha1_to_hex(tagged->sha1));
353 printf(" (%s) in %s\n", tag->tag, sha1_to_hex(tag->object.sha1));
354 return 0;
357 static int fsck_sha1(unsigned char *sha1)
359 struct object *obj = parse_object(sha1);
360 if (!obj) {
361 errors_found |= ERROR_OBJECT;
362 return error("%s: object corrupt or missing",
363 sha1_to_hex(sha1));
365 if (obj->flags & SEEN)
366 return 0;
367 obj->flags |= SEEN;
368 if (obj->type == OBJ_BLOB)
369 return 0;
370 if (obj->type == OBJ_TREE)
371 return fsck_tree((struct tree *) obj);
372 if (obj->type == OBJ_COMMIT)
373 return fsck_commit((struct commit *) obj);
374 if (obj->type == OBJ_TAG)
375 return fsck_tag((struct tag *) obj);
377 /* By now, parse_object() would've returned NULL instead. */
378 return objerror(obj, "unknown type '%d' (internal fsck error)",
379 obj->type);
383 * This is the sorting chunk size: make it reasonably
384 * big so that we can sort well..
386 #define MAX_SHA1_ENTRIES (1024)
388 struct sha1_entry {
389 unsigned long ino;
390 unsigned char sha1[20];
393 static struct {
394 unsigned long nr;
395 struct sha1_entry *entry[MAX_SHA1_ENTRIES];
396 } sha1_list;
398 static int ino_compare(const void *_a, const void *_b)
400 const struct sha1_entry *a = _a, *b = _b;
401 unsigned long ino1 = a->ino, ino2 = b->ino;
402 return ino1 < ino2 ? -1 : ino1 > ino2 ? 1 : 0;
405 static void fsck_sha1_list(void)
407 int i, nr = sha1_list.nr;
409 if (SORT_DIRENT)
410 qsort(sha1_list.entry, nr,
411 sizeof(struct sha1_entry *), ino_compare);
412 for (i = 0; i < nr; i++) {
413 struct sha1_entry *entry = sha1_list.entry[i];
414 unsigned char *sha1 = entry->sha1;
416 sha1_list.entry[i] = NULL;
417 fsck_sha1(sha1);
418 free(entry);
420 sha1_list.nr = 0;
423 static void add_sha1_list(unsigned char *sha1, unsigned long ino)
425 struct sha1_entry *entry = xmalloc(sizeof(*entry));
426 int nr;
428 entry->ino = ino;
429 hashcpy(entry->sha1, sha1);
430 nr = sha1_list.nr;
431 if (nr == MAX_SHA1_ENTRIES) {
432 fsck_sha1_list();
433 nr = 0;
435 sha1_list.entry[nr] = entry;
436 sha1_list.nr = ++nr;
439 static void fsck_dir(int i, char *path)
441 DIR *dir = opendir(path);
442 struct dirent *de;
444 if (!dir)
445 return;
447 while ((de = readdir(dir)) != NULL) {
448 char name[100];
449 unsigned char sha1[20];
450 int len = strlen(de->d_name);
452 switch (len) {
453 case 2:
454 if (de->d_name[1] != '.')
455 break;
456 case 1:
457 if (de->d_name[0] != '.')
458 break;
459 continue;
460 case 38:
461 sprintf(name, "%02x", i);
462 memcpy(name+2, de->d_name, len+1);
463 if (get_sha1_hex(name, sha1) < 0)
464 break;
465 add_sha1_list(sha1, DIRENT_SORT_HINT(de));
466 continue;
468 fprintf(stderr, "bad sha1 file: %s/%s\n", path, de->d_name);
470 closedir(dir);
473 static int default_refs;
475 static int fsck_handle_reflog_ent(unsigned char *osha1, unsigned char *nsha1,
476 const char *email, unsigned long timestamp, int tz,
477 const char *message, void *cb_data)
479 struct object *obj;
481 if (!is_null_sha1(osha1)) {
482 obj = lookup_object(osha1);
483 if (obj) {
484 obj->used = 1;
485 mark_reachable(obj, REACHABLE);
488 obj = lookup_object(nsha1);
489 if (obj) {
490 obj->used = 1;
491 mark_reachable(obj, REACHABLE);
493 return 0;
496 static int fsck_handle_reflog(const char *logname, const unsigned char *sha1, int flag, void *cb_data)
498 for_each_reflog_ent(logname, fsck_handle_reflog_ent, NULL);
499 return 0;
502 static int fsck_handle_ref(const char *refname, const unsigned char *sha1, int flag, void *cb_data)
504 struct object *obj;
506 obj = lookup_object(sha1);
507 if (!obj) {
508 if (has_sha1_file(sha1)) {
509 default_refs++;
510 return 0; /* it is in a pack */
512 error("%s: invalid sha1 pointer %s", refname, sha1_to_hex(sha1));
513 /* We'll continue with the rest despite the error.. */
514 return 0;
516 default_refs++;
517 obj->used = 1;
518 mark_reachable(obj, REACHABLE);
520 return 0;
523 static void get_default_heads(void)
525 for_each_ref(fsck_handle_ref, NULL);
526 for_each_reflog(fsck_handle_reflog, NULL);
529 * Not having any default heads isn't really fatal, but
530 * it does mean that "--unreachable" no longer makes any
531 * sense (since in this case everything will obviously
532 * be unreachable by definition.
534 * Showing dangling objects is valid, though (as those
535 * dangling objects are likely lost heads).
537 * So we just print a warning about it, and clear the
538 * "show_unreachable" flag.
540 if (!default_refs) {
541 fprintf(stderr, "notice: No default references\n");
542 show_unreachable = 0;
546 static void fsck_object_dir(const char *path)
548 int i;
549 for (i = 0; i < 256; i++) {
550 static char dir[4096];
551 sprintf(dir, "%s/%02x", path, i);
552 fsck_dir(i, dir);
554 fsck_sha1_list();
557 static int fsck_head_link(void)
559 unsigned char sha1[20];
560 int flag;
561 int null_is_error = 0;
562 const char *head_points_at = resolve_ref("HEAD", sha1, 0, &flag);
564 if (!head_points_at)
565 return error("Invalid HEAD");
566 if (!strcmp(head_points_at, "HEAD"))
567 /* detached HEAD */
568 null_is_error = 1;
569 else if (prefixcmp(head_points_at, "refs/heads/"))
570 return error("HEAD points to something strange (%s)",
571 head_points_at);
572 if (is_null_sha1(sha1)) {
573 if (null_is_error)
574 return error("HEAD: detached HEAD points at nothing");
575 fprintf(stderr, "notice: HEAD points to an unborn branch (%s)\n",
576 head_points_at + 11);
578 return 0;
581 static int fsck_cache_tree(struct cache_tree *it)
583 int i;
584 int err = 0;
586 if (0 <= it->entry_count) {
587 struct object *obj = parse_object(it->sha1);
588 if (!obj) {
589 error("%s: invalid sha1 pointer in cache-tree",
590 sha1_to_hex(it->sha1));
591 return 1;
593 mark_reachable(obj, REACHABLE);
594 obj->used = 1;
595 if (obj->type != OBJ_TREE)
596 err |= objerror(obj, "non-tree in cache-tree");
598 for (i = 0; i < it->subtree_nr; i++)
599 err |= fsck_cache_tree(it->down[i]->cache_tree);
600 return err;
603 static const char fsck_usage[] =
604 "git-fsck [--tags] [--root] [[--unreachable] [--cache] [--full] "
605 "[--strict] <head-sha1>*]";
607 int cmd_fsck(int argc, char **argv, const char *prefix)
609 int i, heads;
611 track_object_refs = 1;
612 errors_found = 0;
614 for (i = 1; i < argc; i++) {
615 const char *arg = argv[i];
617 if (!strcmp(arg, "--unreachable")) {
618 show_unreachable = 1;
619 continue;
621 if (!strcmp(arg, "--tags")) {
622 show_tags = 1;
623 continue;
625 if (!strcmp(arg, "--root")) {
626 show_root = 1;
627 continue;
629 if (!strcmp(arg, "--cache")) {
630 keep_cache_objects = 1;
631 continue;
633 if (!strcmp(arg, "--full")) {
634 check_full = 1;
635 continue;
637 if (!strcmp(arg, "--strict")) {
638 check_strict = 1;
639 continue;
641 if (*arg == '-')
642 usage(fsck_usage);
645 fsck_head_link();
646 fsck_object_dir(get_object_directory());
647 if (check_full) {
648 struct alternate_object_database *alt;
649 struct packed_git *p;
650 prepare_alt_odb();
651 for (alt = alt_odb_list; alt; alt = alt->next) {
652 char namebuf[PATH_MAX];
653 int namelen = alt->name - alt->base;
654 memcpy(namebuf, alt->base, namelen);
655 namebuf[namelen - 1] = 0;
656 fsck_object_dir(namebuf);
658 prepare_packed_git();
659 for (p = packed_git; p; p = p->next)
660 /* verify gives error messages itself */
661 verify_pack(p, 0);
663 for (p = packed_git; p; p = p->next) {
664 uint32_t i, num = num_packed_objects(p);
665 for (i = 0; i < num; i++) {
666 unsigned char sha1[20];
667 nth_packed_object_sha1(p, i, sha1);
668 fsck_sha1(sha1);
673 heads = 0;
674 for (i = 1; i < argc; i++) {
675 const char *arg = argv[i];
677 if (*arg == '-')
678 continue;
680 if (!get_sha1(arg, head_sha1)) {
681 struct object *obj = lookup_object(head_sha1);
683 /* Error is printed by lookup_object(). */
684 if (!obj)
685 continue;
687 obj->used = 1;
688 mark_reachable(obj, REACHABLE);
689 heads++;
690 continue;
692 error("invalid parameter: expected sha1, got '%s'", arg);
696 * If we've not been given any explicit head information, do the
697 * default ones from .git/refs. We also consider the index file
698 * in this case (ie this implies --cache).
700 if (!heads) {
701 get_default_heads();
702 keep_cache_objects = 1;
705 if (keep_cache_objects) {
706 int i;
707 read_cache();
708 for (i = 0; i < active_nr; i++) {
709 struct blob *blob = lookup_blob(active_cache[i]->sha1);
710 struct object *obj;
711 if (!blob)
712 continue;
713 obj = &blob->object;
714 obj->used = 1;
715 mark_reachable(obj, REACHABLE);
717 if (active_cache_tree)
718 fsck_cache_tree(active_cache_tree);
721 check_connectivity();
722 return errors_found;