summaryrefslogtreecommitdiff
path: root/doc/walkthrough/fsck__58___verifying_your_data.mdwn
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2016-03-12 12:57:18 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2016-03-12 12:57:18 -0400
commitca10c06819aacc50d4423836ce51fc4486803789 (patch)
treee96072aef36f12d28d715fd4b7396d3fea4eef4c /doc/walkthrough/fsck__58___verifying_your_data.mdwn
parent024dd384140b25f69defd762e41fd5e4af4f3567 (diff)
rename files containing :
This is mostly to let the repo check out on windows w/o using cygwin's git. But, bash completion is also crap with : , so ..
Diffstat (limited to 'doc/walkthrough/fsck__58___verifying_your_data.mdwn')
-rw-r--r--doc/walkthrough/fsck__58___verifying_your_data.mdwn36
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/walkthrough/fsck__58___verifying_your_data.mdwn b/doc/walkthrough/fsck__58___verifying_your_data.mdwn
new file mode 100644
index 000000000..240014610
--- /dev/null
+++ b/doc/walkthrough/fsck__58___verifying_your_data.mdwn
@@ -0,0 +1,36 @@
+You can use the fsck subcommand to check for problems in your data. What
+can be checked depends on the key-value [[backend|backends]] you've used
+for the data. For example, when you use the SHA1 backend, fsck will verify
+that the checksums of your files are good. Fsck also checks that the
+[[numcopies|copies]] setting is satisfied for all files.
+
+ # git annex fsck
+ fsck some_file (checksum...) ok
+ fsck my_cool_big_file (checksum...) ok
+ ...
+
+You can also specify the files to check. This is particularly useful if
+you're using sha1 and don't want to spend a long time checksumming everything.
+
+ # git annex fsck my_cool_big_file
+ fsck my_cool_big_file (checksum...) ok
+
+If you have a large repo, you may want to check it in smaller steps. You may
+start and continue an aborted or time-limited check.
+
+ # git annex fsck -S <optional-directory> --time-limit=1m
+ fsck some_file (checksum...) ok
+ fsck my_cool_big_file (checksum...) ok
+
+ Time limit (1m) reached!
+
+ # git annex fsck -m <optional-directory>
+ fsck my_other_big_file (checksum...) ok
+ ...
+
+Use `-S` or `--incremental` to start the incremental check. Use `-m`
+or `--more` to continue the started check and continue where it left
+off. Note that saving the progress of `fsck` is performed after every
+1000 files or 5 minutes or when `--time-limit` occours. There may be
+files that will be checked again when `git-annex` exists abnormally
+eg. Ctrl+C and the check is restarted.