diff options
Diffstat (limited to 'doc/git-annex.mdwn')
-rw-r--r-- | doc/git-annex.mdwn | 19 |
1 files changed, 18 insertions, 1 deletions
diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn index 5d61b8b40..692641caf 100644 --- a/doc/git-annex.mdwn +++ b/doc/git-annex.mdwn @@ -601,7 +601,7 @@ subdirectories). `--format`. The default output format is the same as `--format='${file}\\n'` These variables are available for use in formats: file, key, backend, - bytesize, humansize + bytesize, humansize, keyname, hashdirlower, hashdirmixed, mtime. * `whereis [path ...]` @@ -734,6 +734,23 @@ subdirectories). the file is not added to git, or is not a git-annex managed file), nothing is output, and it exits nonzero. +* `examinekey [key ...]` + + This plumbing-level command is given a key, and prints information + that can be determined purely by looking at the key. + + To specify what information to print, use `--format`. Or use `--json` + to get all available information in JSON format. + + The same variables can be used in the format string as can be used in + the format string of git annex find (except there is no file option + here). + + For example, the location a key's value is stored (in indirect mode) + can be looked up by running: + + git annex examinekey --format='.git/annex/objects/${hashdirmixed}${key}/${key}' + * `fromkey key file` This plumbing-level command can be used to manually set up a file |