diff options
Diffstat (limited to 'doc/gpgv.texi')
-rw-r--r-- | doc/gpgv.texi | 115 |
1 files changed, 115 insertions, 0 deletions
diff --git a/doc/gpgv.texi b/doc/gpgv.texi new file mode 100644 index 000000000..cc83e6a2d --- /dev/null +++ b/doc/gpgv.texi @@ -0,0 +1,115 @@ +\input texinfo +@c This Texinfo document has been automatically generated by +@c docbook2texi from a DocBook documentation. The tool used +@c can be found at: +@c <URL:http://shell.ipoline.com/~elmert/hacks/docbook2X/> +@c Please send any bug reports, improvements, comments, +@c patches, etc. to Steve Cheng <steve@ggi-project.org>. + +@setfilename gpgv.info + +@node top +@top gpgv +@menu +@end menu + +@majorheading Name +gpgv ---- signature verification tool + +@majorheading Synopsis + +@majorheading DESCRIPTION +@code{gpgv} is the OpenPGP signature checking tool. + +This program is a stripped down version of @code{gpg} which is only +able +to check signatures. It is somewhat smaller than the full blown +@code{gpg} and uses a different (and more simple way) to check that +the public keys used to made the signature are trustworth. There is +no options files and only very few options are implemented. + +@code{gpgv} assumes that all keys in the keyring are trustworty. +It uses by default a keyring named @file{trustedkeys.gpg} which is +assumed to be in the home directory as defined by GnuPG or set by an +option or an environment variable. An option may be used to specify +another keyring or even multiple keyrings. + +@majorheading OPTIONS +@code{gpgv} recognizes these options: + +@table @asis +@item -v, ---verbose +Give more information during processing. If used +twice, the input data is listed in detail. + +@item -q, ---quiet +Try to be as quiet as possible. + +@item ---keyring @code{file} +Add @code{file} to the list of keyrings. +If @code{file} begins with a tilde and a slash, these +are replaced by the HOME directory. If the filename +does not contain a slash, it is assumed to be in the +home-directory ("~/.gnupg" if ---homedir is not used). +The filename may be prefixed with a scheme: + +"gnupg-ring:" is the default one. + +It might make sense to use it together with ---no-default-keyring. + +@item ---homedir @code{directory} +Set the name of the home directory to @code{directory} If this +option is not used it defaults to "~/.gnupg". It does +not make sense to use this in a options file. This +also overrides the environment variable "GNUPGHOME". + +@item ---status-fd @code{n} +Write special status strings to the file descriptor @code{n}. +See the file DETAILS in the documentation for a listing of them. + +@item ---logger-fd @code{n} +Write log output to file descriptor @code{n} and not to stderr. + +@item ---ignore-time-conflict +GnuPG normally checks that the timestamps associated with keys and +signatures have plausible values. However, sometimes a signature seems to +be older than the key due to clock problems. This option makes these +checks just a warning. + +@end table + +@majorheading RETURN VALUE +The program returns 0 if everything was fine, 1 if at least +one signature was bad, and other error codes for fatal errors. + +@majorheading EXAMPLES +@table @asis +@item gpgv @code{pgpfile} +@itemx gpgv @code{sigfile} @code{files} +Verify the signature of the file. The second form +is used for detached signatures, where @code{sigfile} is the detached +signature (either ASCII armored or binary) and @code{files} are the signed +data; if this is not given the name of the file holding the signed data is +constructed by cutting off the extension (".asc", ".sig" or ".sign") from +@code{sigfile}. + +@end table + +@majorheading ENVIRONMENT +@table @asis +@item HOME +Used to locate the default home directory. + +@item GNUPGHOME +If set directory used instead of "~/.gnupg". + +@end table + +@majorheading FILES +@table @asis +@item ~/.gnupg/trustedkeys.gpg +The default keyring with the allowed keys + +@end table + +@bye |