You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
145 lines
4.5 KiB
145 lines
4.5 KiB
git-fsck-objects(1) |
|
=================== |
|
v0.1, May 2005 |
|
|
|
NAME |
|
---- |
|
git-fsck-objects - Verifies the connectivity and validity of the objects in the database |
|
|
|
|
|
SYNOPSIS |
|
-------- |
|
'git-fsck-objects' [--tags] [--root] [--unreachable] [--cache] [--standalone | --full] [--strict] [<object>*] |
|
|
|
DESCRIPTION |
|
----------- |
|
Verifies the connectivity and validity of the objects in the database. |
|
|
|
OPTIONS |
|
------- |
|
<object>:: |
|
An object to treat as the head of an unreachability trace. |
|
+ |
|
If no objects are given, git-fsck-objects defaults to using the |
|
index file and all SHA1 references in .git/refs/* as heads. |
|
|
|
--unreachable:: |
|
Print out objects that exist but that aren't readable from any |
|
of the reference nodes. |
|
|
|
--root:: |
|
Report root nodes. |
|
|
|
--tags:: |
|
Report tags. |
|
|
|
--cache:: |
|
Consider any object recorded in the cache also as a head node for |
|
an unreachability trace. |
|
|
|
--standalone:: |
|
Limit checks to the contents of GIT_OBJECT_DIRECTORY |
|
($GIT_DIR/objects), making sure that it is consistent and |
|
complete without referring to objects found in alternate |
|
object pools listed in GIT_ALTERNATE_OBJECT_DIRECTORIES, |
|
nor packed GIT archives found in $GIT_DIR/objects/pack; |
|
cannot be used with --full. |
|
|
|
--full:: |
|
Check not just objects in GIT_OBJECT_DIRECTORY |
|
($GIT_DIR/objects), but also the ones found in alternate |
|
object pools listed in GIT_ALTERNATE_OBJECT_DIRECTORIES, |
|
and in packed GIT archives found in $GIT_DIR/objects/pack |
|
and corresponding pack subdirectories in alternate |
|
object pools; cannot be used with --standalone. |
|
|
|
--strict:: |
|
Enable more strict checking, namely to catch a file mode |
|
recorded with g+w bit set, which was created by older |
|
versions of GIT. Existing repositories, including the |
|
Linux kernel, GIT itself, and sparse repository have old |
|
objects that triggers this check, but it is recommended |
|
to check new projects with this flag. |
|
|
|
It tests SHA1 and general object sanity, and it does full tracking of |
|
the resulting reachability and everything else. It prints out any |
|
corruption it finds (missing or bad objects), and if you use the |
|
'--unreachable' flag it will also print out objects that exist but |
|
that aren't readable from any of the specified head nodes. |
|
|
|
So for example |
|
|
|
git-fsck-objects --unreachable $(cat .git/HEAD .git/refs/heads/*) |
|
|
|
will do quite a _lot_ of verification on the tree. There are a few |
|
extra validity tests to be added (make sure that tree objects are |
|
sorted properly etc), but on the whole if "git-fsck-objects" is happy, you |
|
do have a valid tree. |
|
|
|
Any corrupt objects you will have to find in backups or other archives |
|
(ie you can just remove them and do an "rsync" with some other site in |
|
the hopes that somebody else has the object you have corrupted). |
|
|
|
Of course, "valid tree" doesn't mean that it wasn't generated by some |
|
evil person, and the end result might be crap. Git is a revision |
|
tracking system, not a quality assurance system ;) |
|
|
|
Extracted Diagnostics |
|
--------------------- |
|
|
|
expect dangling commits - potential heads - due to lack of head information:: |
|
You haven't specified any nodes as heads so it won't be |
|
possible to differentiate between un-parented commits and |
|
root nodes. |
|
|
|
missing sha1 directory '<dir>':: |
|
The directory holding the sha1 objects is missing. |
|
|
|
unreachable <type> <object>:: |
|
The <type> object <object>, isn't actually referred to directly |
|
or indirectly in any of the trees or commits seen. This can |
|
mean that there's another root node that you're not specifying |
|
or that the tree is corrupt. If you haven't missed a root node |
|
then you might as well delete unreachable nodes since they |
|
can't be used. |
|
|
|
missing <type> <object>:: |
|
The <type> object <object>, is referred to but isn't present in |
|
the database. |
|
|
|
dangling <type> <object>:: |
|
The <type> object <object>, is present in the database but never |
|
'directly' used. A dangling commit could be a root node. |
|
|
|
warning: git-fsck-objects: tree <tree> has full pathnames in it:: |
|
And it shouldn't... |
|
|
|
sha1 mismatch <object>:: |
|
The database has an object who's sha1 doesn't match the |
|
database value. |
|
This indicates a serious data integrity problem. |
|
|
|
Environment Variables |
|
--------------------- |
|
|
|
GIT_OBJECT_DIRECTORY:: |
|
used to specify the object database root (usually $GIT_DIR/objects) |
|
|
|
GIT_INDEX_FILE:: |
|
used to specify the index file of the cache |
|
|
|
GIT_ALTERNATE_OBJECT_DIRECTORIES:: |
|
used to specify additional object database roots (usually unset) |
|
|
|
Author |
|
------ |
|
Written by Linus Torvalds <torvalds@osdl.org> |
|
|
|
Documentation |
|
-------------- |
|
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. |
|
|
|
GIT |
|
--- |
|
Part of the gitlink:git[7] suite |
|
|
|
|