.TH git-annex-lookupkey 1
.SH NAME
git-annex-lookupkey \- looks up key used for file
.PP
.SH SYNOPSIS
git annex lookupkey \fB[file ...]\fP
.PP
.SH DESCRIPTION
This plumbing\-level command looks up the key used for a file in the
index. The key is output to stdout. If there is no key (because
the file is not present in the index, or is not a git-annex managed file),
nothing is output, and it exits nonzero.
.PP
.SH OPTIONS
.IP "\fB\-\-ref\fP"
.IP
Rather than looking for the specified files in the index, interpet them
as git refs. For example to find the key used for somefile in tag v1.0:
.IP
git-annex lookupkey v1.0:somefile
.IP
.IP "\fB\-\-batch\fP"
Enable batch mode, in which a line containing the filename is read from
stdin, the key is output to stdout (with a trailing newline), and repeat.
.IP
Note that if there is no key corresponding to the file, an empty line is
output to stdout instead.
.IP
.IP "\fB\-z\fP"
Makes the \fB\-\-batch\fP input be delimited by nulls instead of the usual
newlines.
.IP
.IP "Also the git-annex\-common\-options(1) can be used."
.SH SEE ALSO
git-annex(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP