~ubuntu-branches/ubuntu/hardy/gnupg/hardy-updates

« back to all changes in this revision

Viewing changes to doc/gpgv.info

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2006-12-12 15:56:56 UTC
  • mto: This revision was merged to the branch mainline in revision 14.
  • Revision ID: james.westby@ubuntu.com-20061212155656-kk00wp4x0uq4tm1y
Tags: upstream-1.4.6
ImportĀ upstreamĀ versionĀ 1.4.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
This is gpgv.info, produced by makeinfo version 4.8 from gpgv.texi.
2
 
 
3
 
INFO-DIR-SECTION GnuPG
4
 
START-INFO-DIR-ENTRY
5
 
* gpgv: (gpgv).                       GnuPG signature verification tool.
6
 
END-INFO-DIR-ENTRY
7
 
 
8
 
 
9
 
File: gpgv.info,  Node: Top,  Up: (dir)
10
 
 
11
 
gpgv
12
 
****
13
 
 
14
 
Name
15
 
****
16
 
 
17
 
gpgv -- signature verification tool
18
 
 
19
 
Synopsis
20
 
********
21
 
 
22
 
     gpgv
23
 
      options
24
 
      signed files
25
 
 
26
 
DESCRIPTION
27
 
***********
28
 
 
29
 
`gpgv' is the OpenPGP signature checking tool.
30
 
 
31
 
   This program is a stripped down version of `gpg' which is able only
32
 
to check signatures. It is somewhat smaller than the fully blown `gpg'
33
 
and uses a different (and simpler) way to check that the public keys
34
 
used to make the signature are trustworthy. There are no options files
35
 
and only very few options are implemented.
36
 
 
37
 
   `gpgv' assumes that all keys in the keyring are trustworthy.  By
38
 
default it uses a keyring named `trustedkeys.gpg' which is assumed to
39
 
be in the home directory as defined by GnuPG or set by an option or an
40
 
environment variable. An option may be used to specify another keyring
41
 
or even multiple keyrings.
42
 
 
43
 
OPTIONS
44
 
*******
45
 
 
46
 
`gpgv' recognizes these options:
47
 
 
48
 
-v, -verbose
49
 
     Gives more information during processing. If used twice, the input
50
 
     data is listed in detail.
51
 
 
52
 
-q, -quiet
53
 
     Try to be as quiet as possible.
54
 
 
55
 
-keyring `file'
56
 
     Add `file' to the list of keyrings.  If `file' begins with a tilde
57
 
     and a slash, these are replaced by the HOME directory. If the
58
 
     filename does not contain a slash, it is assumed to be in the
59
 
     home-directory ("~/.gnupg" if -homedir is not used).  The filename
60
 
     may be prefixed with a scheme:
61
 
 
62
 
     "gnupg-ring:" is the default one.
63
 
 
64
 
-homedir `directory'
65
 
     Set the name of the home directory to `directory' If this option
66
 
     is not used, it defaults to "~/.gnupg". It does not make sense to
67
 
     use this in an options file. This also overrides the environment
68
 
     variable "GNUPGHOME".
69
 
 
70
 
-status-fd `n'
71
 
     Write special status strings to the file descriptor `n'.  See the
72
 
     file DETAILS in the documentation for a listing of them.
73
 
 
74
 
-logger-fd `n'
75
 
     Write log output to file descriptor `n' and not to stderr.
76
 
 
77
 
-ignore-time-conflict
78
 
     GnuPG normally checks that the timestamps associated with keys and
79
 
     signatures have plausible values. However, sometimes a signature
80
 
     seems to be older than the key due to clock problems. This option
81
 
     makes these checks just warnings.
82
 
 
83
 
RETURN VALUE
84
 
************
85
 
 
86
 
The program returns 0 if everything was fine, 1 if at least one
87
 
signature was bad, and other error codes for fatal errors.
88
 
 
89
 
EXAMPLES
90
 
********
91
 
 
92
 
gpgv `pgpfile'
93
 
gpgv `sigfile'
94
 
     Verify the signature of the file. The second form is used for
95
 
     detached signatures, where `sigfile' is the detached signature
96
 
     (either ASCII armored or binary) and are the signed data; if this
97
 
     is not given the name of the file holding the signed data is
98
 
     constructed by cutting off the extension (".asc", ".sig" or
99
 
     ".sign") from `sigfile'.
100
 
 
101
 
ENVIRONMENT
102
 
***********
103
 
 
104
 
HOME
105
 
     Used to locate the default home directory.
106
 
 
107
 
GNUPGHOME
108
 
     If set directory used instead of "~/.gnupg".
109
 
 
110
 
FILES
111
 
*****
112
 
 
113
 
~/.gnupg/trustedkeys.gpg
114
 
     The default keyring with the allowed keys
115
 
 
116
 
 
117
 
 
118
 
Tag Table:
119
 
Node: Top206
120
 
 
121
 
End Tag Table