Change default keyserver.
[gnupg.git] / g10 / options.skel
1 # These first three lines are not copied to the gpg.conf file in
2 # the users home directory.
3 # $Id$
4 # Options for GnuPG
5 # Copyright 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
6
7 # This file is free software; as a special exception the author gives
8 # unlimited permission to copy and/or distribute it, with or without
9 # modifications, as long as this notice is preserved.
10
11 # This file is distributed in the hope that it will be useful, but
12 # WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
13 # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
14 #
15 # Unless you specify which option file to use (with the command line
16 # option "--options filename"), GnuPG uses the file ~/.gnupg/gpg.conf
17 # by default.
18 #
19 # An options file can contain any long options which are available in
20 # GnuPG. If the first non white space character of a line is a '#',
21 # this line is ignored.  Empty lines are also ignored.
22 #
23 # See the man page for a list of options.
24
25 # Uncomment the following option to get rid of the copyright notice
26
27 #no-greeting
28
29 # If you have more than 1 secret key in your keyring, you may want to
30 # uncomment the following option and set your preferred keyid.
31
32 #default-key 621CC013
33
34 # If you do not pass a recipient to gpg, it will ask for one.  Using
35 # this option you can encrypt to a default key.  Key validation will
36 # not be done in this case.  The second form uses the default key as
37 # default recipient.
38
39 #default-recipient some-user-id
40 #default-recipient-self
41
42 # Use --encrypt-to to add the specified key as a recipient to all
43 # messages.  This is useful, for example, when sending mail through a
44 # mail client that does not automatically encrypt mail to your key.
45 # In the example, this option allows you to read your local copy of
46 # encrypted mail that you've sent to others.
47
48 #encrypt-to some-key-id
49
50 # By default GnuPG creates version 3 signatures for data files.  This
51 # is not strictly OpenPGP compliant but PGP 6 and most versions of PGP
52 # 7 require them.  To disable this behavior, you may use this option
53 # or --openpgp.
54
55 #no-force-v3-sigs
56
57 # Because some mailers change lines starting with "From " to ">From "
58 # it is good to handle such lines in a special way when creating
59 # cleartext signatures; all other PGP versions do it this way too.
60
61 #no-escape-from-lines
62
63 # If you do not use the Latin-1 (ISO-8859-1) charset, you should tell
64 # GnuPG which is the native character set.  Please check the man page
65 # for supported character sets.  This character set is only used for
66 # metadata and not for the actual message which does not undergo any
67 # translation.  Note that future version of GnuPG will change to UTF-8
68 # as default character set.  In most cases this option is not required
69 # as GnuPG is able to figure out the correct charset at runtime.
70
71 #charset utf-8
72
73 # Group names may be defined like this:
74 #   group mynames = paige 0x12345678 joe patti
75 #
76 # Any time "mynames" is a recipient (-r or --recipient), it will be
77 # expanded to the names "paige", "joe", and "patti", and the key ID
78 # "0x12345678".  Note there is only one level of expansion - you
79 # cannot make an group that points to another group.  Note also that
80 # if there are spaces in the recipient name, this will appear as two
81 # recipients.  In these cases it is better to use the key ID.
82
83 #group mynames = paige 0x12345678 joe patti
84
85 # Lock the file only once for the lifetime of a process.  If you do
86 # not define this, the lock will be obtained and released every time
87 # it is needed, which is usually preferable.
88
89 #lock-once
90
91 # GnuPG can send and receive keys to and from a keyserver.  These
92 # servers can be HKP, email, or LDAP (if GnuPG is built with LDAP
93 # support).
94 #
95 # Example HKP keyserver:
96 #      hkp://keys.gnupg.net
97 #      hkp://subkeys.pgp.net
98 #
99 # Example email keyserver:
100 #      mailto:pgp-public-keys@keys.pgp.net
101 #
102 # Example LDAP keyservers:
103 #      ldap://keyserver.pgp.com
104 #
105 # Regular URL syntax applies, and you can set an alternate port
106 # through the usual method:
107 #      hkp://keyserver.example.net:22742
108 #
109 # Most users just set the name and type of their preferred keyserver.
110 # Note that most servers (with the notable exception of
111 # ldap://keyserver.pgp.com) synchronize changes with each other.  Note
112 # also that a single server name may actually point to multiple
113 # servers via DNS round-robin.  hkp://keys.gnupg.net is an example of
114 # such a "server", which spreads the load over a number of physical
115 # servers.  To see the IP address of the server actually used, you may use
116 # the "--keyserver-options debug".
117
118 keyserver hkp://keys.pgp.net
119 #keyserver mailto:pgp-public-keys@keys.nl.pgp.net
120 #keyserver ldap://keyserver.pgp.com
121
122 # Common options for keyserver functions:
123 #
124 # include-disabled : when searching, include keys marked as "disabled"
125 #                    on the keyserver (not all keyservers support this).
126 #
127 # no-include-revoked : when searching, do not include keys marked as
128 #                      "revoked" on the keyserver.
129 #
130 # verbose : show more information as the keys are fetched.
131 #           Can be used more than once to increase the amount
132 #           of information shown.
133 #
134 # use-temp-files : use temporary files instead of a pipe to talk to the
135 #                  keyserver.  Some platforms (Win32 for one) always
136 #                  have this on.
137 #
138 # keep-temp-files : do not delete temporary files after using them
139 #                   (really only useful for debugging)
140 #
141 # http-proxy="proxy" : set the proxy to use for HTTP and HKP keyservers.
142 #                      This overrides the "http_proxy" environment variable,
143 #                      if any.
144 #
145 # auto-key-retrieve : automatically fetch keys as needed from the keyserver
146 #                     when verifying signatures or when importing keys that
147 #                     have been revoked by a revocation key that is not
148 #                     present on the keyring.
149 #
150 # no-include-attributes : do not include attribute IDs (aka "photo IDs")
151 #                         when sending keys to the keyserver.
152
153 #keyserver-options auto-key-retrieve
154
155 # Display photo user IDs in key listings
156
157 # list-options show-photos
158
159 # Display photo user IDs when a signature from a key with a photo is
160 # verified
161
162 # verify-options show-photos
163
164 # Use this program to display photo user IDs
165 #
166 # %i is expanded to a temporary file that contains the photo.
167 # %I is the same as %i, but the file isn't deleted afterwards by GnuPG.
168 # %k is expanded to the key ID of the key.
169 # %K is expanded to the long OpenPGP key ID of the key.
170 # %t is expanded to the extension of the image (e.g. "jpg").
171 # %T is expanded to the MIME type of the image (e.g. "image/jpeg").
172 # %f is expanded to the fingerprint of the key.
173 # %% is %, of course.
174 #
175 # If %i or %I are not present, then the photo is supplied to the
176 # viewer on standard input.  If your platform supports it, standard
177 # input is the best way to do this as it avoids the time and effort in
178 # generating and then cleaning up a secure temp file.
179 #
180 # If no photo-viewer is provided, GnuPG will look for xloadimage, eog,
181 # or display (ImageMagick).  On Mac OS X and Windows, the default is
182 # to use your regular JPEG image viewer.
183 #
184 # Some other viewers:
185 # photo-viewer "qiv %i"
186 # photo-viewer "ee %i"
187 #
188 # This one saves a copy of the photo ID in your home directory:
189 # photo-viewer "cat > ~/photoid-for-key-%k.%t"
190 #
191 # Use your MIME handler to view photos:
192 # photo-viewer "metamail -q -d -b -c %T -s 'KeyID 0x%k' -f GnuPG"
193
194 # Passphrase agent
195 #
196 # We support the old experimental passphrase agent protocol as well as
197 # the new Assuan based one (currently available in the "newpg" package
198 # at ftp.gnupg.org/gcrypt/alpha/aegypten/).  To make use of the agent,
199 # you have to run an agent as daemon and use the option
200 #
201 # use-agent
202
203 # which tries to use the agent but will fallback to the regular mode
204 # if there is a problem connecting to the agent.  The normal way to
205 # locate the agent is by looking at the environment variable
206 # GPG_AGENT_INFO which should have been set during gpg-agent startup.
207 # In certain situations the use of this variable is not possible, thus
208 # the option
209
210 # --gpg-agent-info=<path>:<pid>:1
211 #
212 # may be used to override it.
213
214 # Automatic key location
215 #
216 # GnuPG can automatically locate and retrieve keys as needed using the
217 # auto-key-locate option.  This happens when encrypting to an email
218 # address (in the "user@example.com" form), and there are no
219 # user@example.com keys on the local keyring.  This option takes the
220 # following arguments, in the order they are to be tried:
221
222 # cert = locate a key using DNS CERT, as specified in RFC-4398.
223 #        GnuPG can handle both the PGP (key) and IPGP (URL + fingerprint)
224 #        CERT methods.
225 #
226 # pka = locate a key using DNS PKA.
227 #
228 # ldap = locate a key using the PGP Universal method of checking
229 #        "ldap://keys.(thedomain)".  For example, encrypting to
230 #        user@example.com will check ldap://keys.example.com.
231 #
232 # keyserver = locate a key using whatever keyserver is defined using
233 #             the keyserver option.
234 #
235 # You may also list arbitrary keyservers here by URL.
236 #
237 # Try CERT, then PKA, then LDAP, then hkp://subkeys.net:
238 #auto-key-locate cert pka ldap hkp://subkeys.pgp.net