git-annex/doc/walkthrough/fsck:_verifying_your_data.mdwn

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
update documentation for new, neutered key-value backends Backends are now only used to generate keys (and check them); they are not arbitrary key-value stores for data, because it turned out such a store is better modeled as a special remote. Updated docs to not imply backends do more than they do now. Sometimes I'm tempted to rename "backend" to "keytype" or something, which would really be more clear. But it would be an annoying transition for users, with annex.backends etc. 2011-08-28 20:28:38 +00:00			`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`
global numcopies setting * numcopies: New command, sets global numcopies value that is seen by all clones of a repository. * The annex.numcopies git config setting is deprecated. Once the numcopies command is used to set the global number of copies, any annex.numcopies git configs will be ignored. * assistant: Make the prefs page set the global numcopies. This global numcopies setting is needed to let preferred content expressions operate on numcopies. It's also convenient, because typically if you want git-annex to preserve N copies of files in a repo, you want it to do that no matter which repo it's running in. Making it global avoids needing to warn the user about gotchas involving inconsistent annex.numcopies settings. (See changes to doc/numcopies.mdwn.) Added a new variety of git-annex branch log file, that holds only 1 value. Will probably be useful for other stuff later. This commit was sponsored by Nicolas Pouillard. 2014-01-20 20:47:56 +00:00			`[[numcopies\|copies]] setting is satisfied for all files.`
split the walkthrough and inline back together 2011-02-27 16:45:48 +00:00
			`# git annex fsck`
improve unused command's output Display the name of the remote being checked, with "." for the current remote, echoing the way describe takes that to change its description. 2011-05-29 02:20:22 +00:00			`fsck some_file (checksum...) ok`
split the walkthrough and inline back together 2011-02-27 16:45:48 +00:00			`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`