* gpg.sgml: Document --edit-key "keyserver" command, --keyid-format,
[gnupg.git] / doc / gpgv.sgml
1 <!-- gpgv.sgml - the man page for GnuPG
2     Copyright (C) 2000, 2001 Free Software Foundation, Inc.
3
4     This file is part of GnuPG.
5
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.
10
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.
15
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
19 -->
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
23      not look very pretty
24
25     FIXME: generated a file with entity (e.g. pathnames) from the
26     configure scripts and include it here
27 -->
28
29
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>">
46 ]>
47
48 <refentry id="gpgv">
49 <refmeta>
50   <refentrytitle>gpgv</refentrytitle>
51   <manvolnum>1</manvolnum>
52   <refmiscinfo class="gnu">GNU Tools</refmiscinfo>
53 </refmeta>
54 <refnamediv>
55   <refname/gpgv/
56   <refpurpose>signature verification tool</>
57 </refnamediv>
58 <refsynopsisdiv>
59   <synopsis>
60 <command>gpgv</command>
61  <optional><parameter/options/</optional>
62  <optional><parameter/signed files/</optional>
63   </synopsis>
64 </refsynopsisdiv>
65
66 <refsect1>
67     <title>DESCRIPTION</title>
68     <para>
69 <command/gpgv/ is the OpenPGP signature checking tool.
70     </para>
71     <para>
72 This program is a stripped down version of <command/gpg/ which is only
73 able
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.
78 </para>
79 <para>
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.
85 </para>
86 </refsect1>
87
88 <refsect1>
89 <title>OPTIONS</title>
90 <para>
91 <command/gpgv/ recognizes these options:
92 </para>
93
94 <variablelist>
95
96
97 <varlistentry>
98 <term>-v, --verbose</term>
99 <listitem><para>
100 Give more information during processing. If used
101 twice, the input data is listed in detail.
102 </para></listitem></varlistentry>
103
104
105 <varlistentry>
106 <term>-q, --quiet</term>
107 <listitem><para>
108 Try to be as quiet as possible.
109 </para></listitem></varlistentry>
110
111
112 <varlistentry>
113 <term>--keyring &ParmFile;</term>
114 <listitem><para>
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 </listitem></varlistentry>
123
124
125 <varlistentry>
126 <term>--homedir &ParmDir;</term>
127 <listitem><para>
128 Set the name of the home directory to &ParmDir; If this
129 option is not used it defaults to "~/.gnupg". It does
130 not make sense to use this in a options file. This
131 also overrides the environment variable "GNUPGHOME".
132 </para></listitem></varlistentry>
133
134
135 <varlistentry>
136 <term>--status-fd &ParmN;</term>
137 <listitem><para>
138 Write special status strings to the file descriptor &ParmN;.
139 See the file DETAILS in the documentation for a listing of them.
140 </para></listitem></varlistentry>
141
142
143 <varlistentry>
144 <term>--logger-fd &ParmN;</term>
145 <listitem><para>
146 Write log output to file descriptor &ParmN; and not to stderr.
147 </para></listitem></varlistentry>
148
149
150 <varlistentry>
151 <term>--ignore-time-conflict</term>
152 <listitem><para>
153 GnuPG normally checks that the timestamps associated with keys and
154 signatures have plausible values.  However, sometimes a signature seems to
155 be older than the key due to clock problems.  This option makes these
156 checks just a warning.
157 </para></listitem></varlistentry>
158
159
160 </variablelist>
161 </refsect1>
162
163
164 <refsect1>
165     <title>RETURN VALUE</title>
166     <para>
167 The program returns 0 if everything was fine, 1 if at least
168 one signature was bad, and other error codes for fatal errors.
169     </para>
170 </refsect1>
171
172 <refsect1>
173     <title>EXAMPLES</title>
174     <variablelist>
175
176 <varlistentry>
177 <term>gpgv <parameter/pgpfile/</term>
178 <term>gpgv <parameter/sigfile/ &OptParmFiles;</term>
179 <listitem><para>
180 Verify the signature of the file. The second form
181 is used for detached signatures, where <parameter/sigfile/ is the detached
182 signature (either ASCII armored or binary) and &OptParmFiles are the signed
183 data; if this is not given the name of the file holding the signed data is
184 constructed by cutting off the extension (".asc", ".sig" or ".sign") from
185 <parameter/sigfile/.
186 </para></listitem></varlistentry>
187
188     </variablelist>
189 </refsect1>
190
191
192 <refsect1>
193     <title>ENVIRONMENT</title>
194
195     <variablelist>
196 <varlistentry>
197 <term>HOME</term>
198 <listitem><para>Used to locate the default home directory.</para></listitem>
199 </varlistentry>
200 <varlistentry>
201 <term>GNUPGHOME</term>
202 <listitem><para>If set directory used instead of "~/.gnupg".</para></listitem>
203 </varlistentry>
204
205     </variablelist>
206
207 </refsect1>
208
209 <refsect1>
210     <title>FILES</title>
211     <variablelist>
212
213 <varlistentry>
214 <term>~/.gnupg/trustedkeys.gpg</term>
215 <listitem><para>The default keyring with the allowed keys</para></listitem>
216 </varlistentry>
217
218     </variablelist>
219 </refsect1>
220
221 <!-- SEE ALSO  not yet needed-->
222
223 </refentry>
224