1
<!-- gpgv.sgml - the man page for GnuPG
2
Copyright (C) 2000, 2001 Free Software Foundation, Inc.
4
This file is part of GnuPG.
6
GnuPG is free software; you can redistribute it and/or modify
7
it under the terms of the GNU General Public License as published by
8
the Free Software Foundation; either version 2 of the License, or
9
(at your option) any later version.
11
GnuPG is distributed in the hope that it will be useful,
12
but WITHOUT ANY WARRANTY; without even the implied warranty of
13
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
GNU General Public License for more details.
16
You should have received a copy of the GNU General Public License
17
along with this program; if not, write to the Free Software
18
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
20
<!-- This file should be processed by docbook-to-man to
21
create a manual page. This program has currently the bug
22
not to remove leading white space. So this source file does
25
FIXME: generated a file with entity (e.g. pathnames) from the
26
configure scripts and include it here
30
<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
31
<!entity ParmDir "<parameter>directory</parameter>">
32
<!entity ParmFile "<parameter>file</parameter>">
33
<!entity OptParmFile "<optional>&ParmFile;</optional>">
34
<!entity ParmFiles "<parameter>files</parameter>">
35
<!entity OptParmFiles "<optional>&ParmFiles;</optional>">
36
<!entity ParmNames "<parameter>names</parameter>">
37
<!entity OptParmNames "<optional>&ParmNames;</optional>">
38
<!entity ParmName "<parameter>name</parameter>">
39
<!entity OptParmName "<optional>&ParmName;</optional>">
40
<!entity ParmKeyIDs "<parameter>key IDs</parameter>">
41
<!entity ParmN "<parameter>n</parameter>">
42
<!entity ParmFlags "<parameter>flags</parameter>">
43
<!entity ParmString "<parameter>string</parameter>">
44
<!entity ParmValue "<parameter>value</parameter>">
45
<!entity ParmNameValue "<parameter>name=value</parameter>">
50
<refentrytitle>gpgv</refentrytitle>
51
<manvolnum>1</manvolnum>
52
<refmiscinfo class="gnu">GNU Tools</refmiscinfo>
56
<refpurpose>signature verification tool</>
61
<optional><parameter/options/</optional>
62
<optional><parameter/signed files/</optional>
67
<title>DESCRIPTION</title>
69
<command/gpgv/ is the OpenPGP signature checking tool.
72
This program is a stripped down version of <command/gpg/ which is only
74
to check signatures. It is somewhat smaller than the full blown
75
<command/gpg/ and uses a different (and more simple way) to check that
76
the public keys used to made the signature are trustworth. There is
77
no options files and only very few options are implemented.
80
<command/gpgv/ assumes that all keys in the keyring are trustworty.
81
It uses by default a keyring named <filename/trustedkeys.gpg/ which is
82
assumed to be in the home directory as defined by GnuPG or set by an
83
option or an environment variable. An option may be used to specify
84
another keyring or even multiple keyrings.
89
<title>OPTIONS</title>
91
<command/gpgv/ recognizes these options:
98
<term>-v, --verbose</term>
100
Give more information during processing. If used
101
twice, the input data is listed in detail.
102
</para></listitem></varlistentry>
106
<term>-q, --quiet</term>
108
Try to be as quiet as possible.
109
</para></listitem></varlistentry>
113
<term>--keyring &ParmFile;</term>
115
Add &ParmFile to the list of keyrings.
116
If &ParmFile begins with a tilde and a slash, these
117
are replaced by the HOME directory. If the filename
118
does not contain a slash, it is assumed to be in the
119
home-directory ("~/.gnupg" if --homedir is not used).
120
The filename may be prefixed with a scheme:</para>
121
<para>"gnupg-ring:" is the default one.</para>
122
<para>It might make sense to use it together with --no-default-keyring.
123
</para></listitem></varlistentry>
127
<term>--homedir &ParmDir;</term>
129
Set the name of the home directory to &ParmDir; If this
130
option is not used it defaults to "~/.gnupg". It does
131
not make sense to use this in a options file. This
132
also overrides the environment variable "GNUPGHOME".
133
</para></listitem></varlistentry>
137
<term>--status-fd &ParmN;</term>
139
Write special status strings to the file descriptor &ParmN;.
140
See the file DETAILS in the documentation for a listing of them.
141
</para></listitem></varlistentry>
145
<term>--logger-fd &ParmN;</term>
147
Write log output to file descriptor &ParmN; and not to stderr.
148
</para></listitem></varlistentry>
152
<term>--ignore-time-conflict</term>
154
GnuPG normally checks that the timestamps associated with keys and
155
signatures have plausible values. However, sometimes a signature seems to
156
be older than the key due to clock problems. This option makes these
157
checks just a warning.
158
</para></listitem></varlistentry>
166
<title>RETURN VALUE</title>
168
The program returns 0 if everything was fine, 1 if at least
169
one signature was bad, and other error codes for fatal errors.
174
<title>EXAMPLES</title>
178
<term>gpgv <parameter/pgpfile/</term>
179
<term>gpgv <parameter/sigfile/ &OptParmFiles;</term>
181
Verify the signature of the file. The second form
182
is used for detached signatures, where <parameter/sigfile/ is the detached
183
signature (either ASCII armored or binary) and &OptParmFiles are the signed
184
data; if this is not given the name of the file holding the signed data is
185
constructed by cutting off the extension (".asc", ".sig" or ".sign") from
187
</para></listitem></varlistentry>
194
<title>ENVIRONMENT</title>
199
<listitem><para>Used to locate the default home directory.</para></listitem>
202
<term>GNUPGHOME</term>
203
<listitem><para>If set directory used instead of "~/.gnupg".</para></listitem>
215
<term>~/.gnupg/trustedkeys.gpg</term>
216
<listitem><para>The default keyring with the allowed keys</para></listitem>
222
<!-- SEE ALSO not yet needed-->