1998-10-25 19:00:01 +00:00
|
|
|
These first three lines are not copied to the options file in
|
|
|
|
the users home directory.
|
|
|
|
$Id$
|
|
|
|
# Options for GnuPG
|
2001-03-08 14:33:24 +00:00
|
|
|
# Copyright 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
|
|
|
|
#
|
|
|
|
# This file is free software; as a special exception the author gives
|
|
|
|
# unlimited permission to copy and/or distribute it, with or without
|
|
|
|
# modifications, as long as this notice is preserved.
|
|
|
|
#
|
|
|
|
# This file is distributed in the hope that it will be useful, but
|
|
|
|
# WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
|
|
|
|
# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
1998-10-25 19:00:01 +00:00
|
|
|
#
|
|
|
|
# Unless you you specify which option file to use (with the
|
|
|
|
# commandline option "--options filename"), GnuPG uses the
|
|
|
|
# file ~/.gnupg/options by default.
|
|
|
|
#
|
|
|
|
# An option file can contain all long options which are
|
|
|
|
# available in GnuPG. If the first non white space character of
|
|
|
|
# a line is a '#', this line is ignored. Empty lines are also
|
|
|
|
# ignored.
|
|
|
|
#
|
|
|
|
# See the man page for a list of options.
|
|
|
|
|
|
|
|
# Uncomment the next line to get rid of the copyright notice
|
|
|
|
#no-greeting
|
|
|
|
|
|
|
|
# If you have more than 1 secret key in your keyring, you may want
|
|
|
|
# to uncomment the following option and set your preffered keyid
|
|
|
|
|
1999-07-22 18:11:55 +00:00
|
|
|
#default-key 621CC013
|
1998-10-25 19:00:01 +00:00
|
|
|
|
2001-04-20 12:21:23 +00:00
|
|
|
|
1999-07-13 15:41:14 +00:00
|
|
|
# If you do not pass a recipient to gpg, it will ask for one.
|
|
|
|
# Using this option you can encrypt to a default key. key validation
|
|
|
|
# will not be done in this case.
|
|
|
|
# The second form uses the default key as default recipient.
|
|
|
|
|
1999-07-22 18:11:55 +00:00
|
|
|
#default-recipient some-user-id
|
|
|
|
#default-recipient-self
|
1999-07-13 15:41:14 +00:00
|
|
|
|
2002-04-18 08:09:56 +00:00
|
|
|
# By default GnuPG creates version 3 signatures for data files. This
|
|
|
|
# is not OpenPGP compliant but PGP 6 requires them. To disable it,
|
|
|
|
# you may use this option or --openpgp.
|
|
|
|
#no-force-v3-sigs
|
1998-10-25 19:00:01 +00:00
|
|
|
|
1998-12-17 17:36:05 +00:00
|
|
|
# Because some mailers change lines starting with "From " to ">From "
|
|
|
|
# it is good to handle such lines in a special way when creating
|
2001-03-12 20:21:50 +00:00
|
|
|
# cleartext signatures; all other PGP versions do it this way too.
|
2002-04-18 08:09:56 +00:00
|
|
|
# To enable full OpenPGP compliance you may want to use this option.
|
|
|
|
#no-escape-from-lines
|
|
|
|
|
|
|
|
# If you do not use the Latin-1 (ISO-8859-1) charset, you should tell
|
|
|
|
# GnuPG which is the native character set. Please check the man page
|
|
|
|
# for supported character sets. This character set is only used for
|
|
|
|
# Meta data and not for the actual message which does not undergo any
|
|
|
|
# translation. Note that future version of GnuPG will change to UTF-8
|
|
|
|
# as default character set.
|
2001-04-20 12:21:23 +00:00
|
|
|
#charset utf-8
|
1998-11-10 12:59:59 +00:00
|
|
|
|
* options.skel, options.h, main.h, keydb.h, pkclist.c (build_pk_list,
expand_groups), g10.c (main, add_group): Add new "group" command to allow
one name to expand into multiple keys. For simplicity, and to avoid
potential loops, we only expand once - you can't make an alias that points
to an alias.
* main.h, g10.c (main), keygen.c (build_personal_digest_list): Simplify
the default digest list - there is really no need for the other hashes
since they will never be used after SHA-1 in the list.
* options.skel, options.h, g10.c (main), hkp.c (hkp_ask_import,
hkp_export, hkp_search), keyserver.c (parse_keyserver_options,
parse_keyserver_uri, keyserver_work, keyserver_refresh): Make the
"x-broken-hkp" keyserver scheme into keyserver-option "broken-http-proxy".
Move honor_http_proxy into keyserver_options. Canonicalize the three
variations of "hkp", "x-hkp", and "x-broken-hkp" into "hkp".
2002-06-07 19:38:27 +00:00
|
|
|
# Group names may be defined like this:
|
|
|
|
# group mynames paige 0x12345678 joe patti
|
|
|
|
#
|
|
|
|
# Any time "mynames" is a receipient (-r or --recipient), it will be
|
|
|
|
# expanded to the names "paige", "joe", and "patti", and the key ID
|
|
|
|
# "0x12345678". Note there is only one level of expansion - you
|
|
|
|
# cannot make an group that points to another group.
|
1998-11-13 19:41:41 +00:00
|
|
|
|
1998-12-14 20:22:42 +00:00
|
|
|
# lock the file only once for the lifetime of a process.
|
1998-11-27 20:40:56 +00:00
|
|
|
# if you do not define this, the lock will be obtained and released
|
|
|
|
# every time it is needed - normally this is not needed.
|
|
|
|
lock-once
|
|
|
|
|
1999-07-13 15:41:14 +00:00
|
|
|
# If you have configured GnuPG without a random gatherer
|
|
|
|
# (./configure --enable-static-rnd=none), you have to
|
|
|
|
# uncomment _one_ of the following lines. These
|
|
|
|
# extensions won't get used if you have a random gatherer
|
|
|
|
# compiled in (which is the default for GNU and xxxBSD systems)
|
1999-03-11 15:42:06 +00:00
|
|
|
#load-extension rndlinux
|
1998-12-14 20:22:42 +00:00
|
|
|
#load-extension rndunix
|
1999-03-11 15:42:06 +00:00
|
|
|
#load-extension rndegd
|
1998-11-27 20:40:56 +00:00
|
|
|
|
2001-12-06 21:43:04 +00:00
|
|
|
# GnuPG can send and receive keys to and from a keyserver. These
|
|
|
|
# servers can be HKP, email, or LDAP (if GnuPG is built with LDAP
|
|
|
|
# support).
|
|
|
|
#
|
|
|
|
# Example HKP keyserver:
|
2002-04-08 15:10:51 +00:00
|
|
|
# x-hkp://keyserver.cryptnet.net
|
2001-12-06 21:43:04 +00:00
|
|
|
#
|
|
|
|
# Example email keyserver:
|
|
|
|
# mailto:pgp-public-keys@keys.nl.pgp.net
|
|
|
|
#
|
|
|
|
# Example LDAP keyserver:
|
2002-05-15 13:15:27 +00:00
|
|
|
# ldap://pgp.surfnet.nl:11370
|
2001-12-06 21:43:04 +00:00
|
|
|
#
|
|
|
|
# Regular URL syntax applies, and you can set an alternate port
|
|
|
|
# through the usual method:
|
|
|
|
# x-hkp://keyserver.example.net:22742
|
2001-04-23 11:44:46 +00:00
|
|
|
#
|
* options.skel, options.h, main.h, keydb.h, pkclist.c (build_pk_list,
expand_groups), g10.c (main, add_group): Add new "group" command to allow
one name to expand into multiple keys. For simplicity, and to avoid
potential loops, we only expand once - you can't make an alias that points
to an alias.
* main.h, g10.c (main), keygen.c (build_personal_digest_list): Simplify
the default digest list - there is really no need for the other hashes
since they will never be used after SHA-1 in the list.
* options.skel, options.h, g10.c (main), hkp.c (hkp_ask_import,
hkp_export, hkp_search), keyserver.c (parse_keyserver_options,
parse_keyserver_uri, keyserver_work, keyserver_refresh): Make the
"x-broken-hkp" keyserver scheme into keyserver-option "broken-http-proxy".
Move honor_http_proxy into keyserver_options. Canonicalize the three
variations of "hkp", "x-hkp", and "x-broken-hkp" into "hkp".
2002-06-07 19:38:27 +00:00
|
|
|
# If you have problems connecting to a HKP server through a buggy http
|
|
|
|
# proxy, you can use keyserver option broken-http-proxy (see below),
|
|
|
|
# but first you should make sure that you have read the man page
|
|
|
|
# regarding proxies (keyserver option honor-http-proxy)
|
2001-12-06 21:43:04 +00:00
|
|
|
#
|
|
|
|
# Most users just set the name and type of their preferred keyserver.
|
2001-12-21 23:06:02 +00:00
|
|
|
# Most servers do synchronize with each other and DNS round-robin may
|
2001-12-06 21:43:04 +00:00
|
|
|
# give you a quasi-random server each time.
|
1999-01-16 08:29:29 +00:00
|
|
|
|
2002-04-08 15:10:51 +00:00
|
|
|
#keyserver x-hkp://keyserver.cryptnet.net
|
2001-12-06 21:43:04 +00:00
|
|
|
#keyserver mailto:pgp-public-keys@keys.nl.pgp.net
|
2002-05-15 13:15:27 +00:00
|
|
|
#keyserver ldap://pgp.surfnet.nl:11370
|
1999-10-08 18:34:56 +00:00
|
|
|
|
2001-12-06 21:43:04 +00:00
|
|
|
# Options for keyserver functions
|
|
|
|
#
|
|
|
|
# include-disabled = when searching, include keys marked as "disabled"
|
|
|
|
# on the keyserver (not all keyservers support this).
|
|
|
|
#
|
|
|
|
# include-revoked = when searching, include keys marked as "revoked"
|
|
|
|
# on the keyserver.
|
|
|
|
#
|
|
|
|
# verbose = show more information as the keys are fetched.
|
2002-03-07 19:44:57 +00:00
|
|
|
# Can be used more than once to increase the amount
|
2001-12-06 21:43:04 +00:00
|
|
|
# of information shown.
|
|
|
|
#
|
|
|
|
# use-temp-files = use temporary files instead of a pipe to talk to the
|
|
|
|
# keyserver. Some platforms (Win32 for one) always
|
|
|
|
# have this on.
|
|
|
|
#
|
2002-03-07 19:44:57 +00:00
|
|
|
# keep-temp-files = do not delete temporary files after using them
|
2001-12-06 21:43:04 +00:00
|
|
|
# (really only useful for debugging)
|
|
|
|
#
|
* options.skel, options.h, main.h, keydb.h, pkclist.c (build_pk_list,
expand_groups), g10.c (main, add_group): Add new "group" command to allow
one name to expand into multiple keys. For simplicity, and to avoid
potential loops, we only expand once - you can't make an alias that points
to an alias.
* main.h, g10.c (main), keygen.c (build_personal_digest_list): Simplify
the default digest list - there is really no need for the other hashes
since they will never be used after SHA-1 in the list.
* options.skel, options.h, g10.c (main), hkp.c (hkp_ask_import,
hkp_export, hkp_search), keyserver.c (parse_keyserver_options,
parse_keyserver_uri, keyserver_work, keyserver_refresh): Make the
"x-broken-hkp" keyserver scheme into keyserver-option "broken-http-proxy".
Move honor_http_proxy into keyserver_options. Canonicalize the three
variations of "hkp", "x-hkp", and "x-broken-hkp" into "hkp".
2002-06-07 19:38:27 +00:00
|
|
|
# honor-http-proxy = if the keyserver uses HTTP, honor the http_proxy
|
2001-12-06 21:43:04 +00:00
|
|
|
# environment variable
|
2002-03-07 19:44:57 +00:00
|
|
|
#
|
* options.skel, options.h, main.h, keydb.h, pkclist.c (build_pk_list,
expand_groups), g10.c (main, add_group): Add new "group" command to allow
one name to expand into multiple keys. For simplicity, and to avoid
potential loops, we only expand once - you can't make an alias that points
to an alias.
* main.h, g10.c (main), keygen.c (build_personal_digest_list): Simplify
the default digest list - there is really no need for the other hashes
since they will never be used after SHA-1 in the list.
* options.skel, options.h, g10.c (main), hkp.c (hkp_ask_import,
hkp_export, hkp_search), keyserver.c (parse_keyserver_options,
parse_keyserver_uri, keyserver_work, keyserver_refresh): Make the
"x-broken-hkp" keyserver scheme into keyserver-option "broken-http-proxy".
Move honor_http_proxy into keyserver_options. Canonicalize the three
variations of "hkp", "x-hkp", and "x-broken-hkp" into "hkp".
2002-06-07 19:38:27 +00:00
|
|
|
# broken-http-proxy = try to work around a buggy HTTP proxy
|
|
|
|
#
|
2002-03-07 19:44:57 +00:00
|
|
|
# auto-key-retrieve = automatically fetch keys as needed from the
|
|
|
|
# keyserver when verifying signatures or when importing
|
|
|
|
# keys that have been revoked by a revocation key that
|
|
|
|
# is not present on the keyring.
|
2001-12-06 21:43:04 +00:00
|
|
|
|
2002-03-07 19:44:57 +00:00
|
|
|
#keyserver-options auto-key-retrieve include-disabled include-revoked
|
2001-04-23 11:44:46 +00:00
|
|
|
|
2001-12-21 23:06:02 +00:00
|
|
|
# Uncomment this line to display photo user IDs in key listings
|
|
|
|
#show-photos
|
2001-04-23 11:44:46 +00:00
|
|
|
|
2001-12-21 23:06:02 +00:00
|
|
|
# Use this program to display photo user IDs
|
|
|
|
#
|
|
|
|
# %i is expanded to a temporary file that contains the photo.
|
|
|
|
# %I is the same as %i, but the file isn't deleted afterwards by GnuPG.
|
|
|
|
# %k is expanded to the key ID of the key.
|
|
|
|
# %K is expanded to the long OpenPGP key ID of the key.
|
2002-04-23 02:48:44 +00:00
|
|
|
# %t is expanded to the extension of the image (e.g. "jpg").
|
|
|
|
# %T is expanded to the MIME type of the image (e.g. "image/jpeg").
|
2001-12-21 23:06:02 +00:00
|
|
|
# %f is expanded to the fingerprint of the key.
|
|
|
|
# %% is %, of course.
|
|
|
|
#
|
|
|
|
# If %i or %I are not present, then the photo is supplied to the
|
2002-05-15 13:15:27 +00:00
|
|
|
# viewer on standard input. If your platform supports it, standard
|
|
|
|
# input is the best way to do this as it avoids the time and effort in
|
|
|
|
# generating and then cleaning up a secure temp file.
|
2001-12-21 23:06:02 +00:00
|
|
|
#
|
|
|
|
# The default program is "xloadimage -fork -quiet -title 'KeyID 0x%k' stdin"
|
|
|
|
#
|
|
|
|
# Some other viewers:
|
2001-12-22 13:04:24 +00:00
|
|
|
# photo-viewer "qiv %i"
|
2001-12-21 23:06:02 +00:00
|
|
|
# photo-viewer "ee %i"
|
|
|
|
# photo-viewer "display -title 'KeyID 0x%k'"
|
|
|
|
#
|
|
|
|
# This one saves a copy of the photo ID in your home directory:
|
2002-04-23 02:48:44 +00:00
|
|
|
# photo-viewer "cat > ~/photoid-for-key-%k.%t"
|
2001-12-21 23:06:02 +00:00
|
|
|
#
|
|
|
|
# Use your MIME handler to view photos:
|
2002-04-23 02:48:44 +00:00
|
|
|
# photo-viewer "metamail -q -d -b -c %T -s 'KeyID 0x%k' -f GnuPG"
|
2002-06-03 12:39:23 +00:00
|
|
|
#
|
|
|
|
# Use the Win32 registry to pick a viewer for you:
|
|
|
|
# On Win95/98/Me (also the default on Win32):
|
|
|
|
# photo-viewer "start /w"
|
|
|
|
# On NT/2k/XP:
|
|
|
|
# photo-viewer "cmd /c start /w"
|
2002-01-26 16:34:00 +00:00
|
|
|
|
|
|
|
|
|
|
|
# Passphrase agent
|
|
|
|
#
|
|
|
|
# We support the old experimental passphrase agent protocol as well
|
|
|
|
# as the new Assuan based one (currently available in the "newpg" package
|
|
|
|
# at ftp.gnupg.org/gcrypt/alpha/aegypten/). To make use of the agent, you have
|
|
|
|
# to run an agent as daemon and use the option
|
|
|
|
#
|
|
|
|
# use-agent
|
|
|
|
#
|
|
|
|
# which tries to use the agent but will fallback to the regular mode
|
|
|
|
# if there is a problem connecting to the agent. The normal way to
|
|
|
|
# locate the agent is by looking at the environment variable
|
|
|
|
# GPG_AGENT_INFO which should have been set during gpg-agent startup.
|
|
|
|
# In certain situations the use of this variable is not possible, thus
|
|
|
|
# the option
|
|
|
|
#
|
|
|
|
# --gpg-agent-info=<path>:<pid>:1
|
|
|
|
#
|
|
|
|
# may be used to override it.
|