diff options
author | Werner Koch <[email protected]> | 2015-04-21 08:15:04 +0000 |
---|---|---|
committer | Werner Koch <[email protected]> | 2015-04-21 08:15:04 +0000 |
commit | da1990bac71f6447d8ebd169c3b3b186e9f287d9 (patch) | |
tree | 900ced4003c49e92bbfaac96a1b8b3cfa4c372b0 /doc | |
parent | Remove the obsolete keyserver directory from the repo. (diff) | |
download | gnupg-da1990bac71f6447d8ebd169c3b3b186e9f287d9.tar.gz gnupg-da1990bac71f6447d8ebd169c3b3b186e9f287d9.zip |
gpg: Update sub-options of --keyserver-options
* g10/options.h (KEYSERVER_HTTP_PROXY): New.
(KEYSERVER_USE_TEMP_FILES, KEYSERVER_KEEP_TEMP_FILES): Remove.
(KEYSERVER_TIMEOUT): New.
* common/keyserver.h (KEYSERVER_TIMEOUT): Remove.
* g10/keyserver.c (keyserver_opts): Remove obsolete "use-temp-files"
and "keep-temp-files". Add "http-proxy" and "timeout".
(parse_keyserver_options): Remove 1.2 compatibility option
"honor-http_proxy". Remove "use-temp-files" and "keep-temp-files"
code.
--
Note that many of these options where implicitly used by passing any
unknown option down to the former keyserver helpers. The don't exist
anymore thus we need to make them explicit. Another patch will convey
them to dirmngr. Temp files are not anymore used thus they can be
removed and will be ignored when used.
Signed-off-by: Werner Koch <[email protected]>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/dirmngr.texi | 2 | ||||
-rw-r--r-- | doc/gpg.texi | 56 |
2 files changed, 39 insertions, 19 deletions
diff --git a/doc/dirmngr.texi b/doc/dirmngr.texi index 6c413de26..cf35c47ed 100644 --- a/doc/dirmngr.texi +++ b/doc/dirmngr.texi @@ -269,7 +269,7 @@ value to access HTTP servers. @item --http-proxy @var{host}[:@var{port}] @opindex http-proxy Use @var{host} and @var{port} to access HTTP servers. The use of this -options overrides the environment variable @env{http_proxy} regardless +option overrides the environment variable @env{http_proxy} regardless whether @option{--honor-http-proxy} has been set. diff --git a/doc/gpg.texi b/doc/gpg.texi index 393cf2417..899c6b8d2 100644 --- a/doc/gpg.texi +++ b/doc/gpg.texi @@ -1545,7 +1545,7 @@ need to send keys to more than one server. The keyserver @code{hkp://keys.gnupg.net} uses round robin DNS to give a different keyserver each time you use it. -@item --keyserver-options @code{name=value1 } +@item --keyserver-options @code{name=value} @opindex keyserver-options This is a space or comma delimited string that gives options for the keyserver. Options can be prefixed with a `no-' to give the opposite @@ -1598,20 +1598,20 @@ are available for all keyserver types, some common options are: this option is not used with HKP keyservers, as they do not support retrieving keys by subkey id. +@ifclear gpgtwoone @item use-temp-files On most Unix-like platforms, GnuPG communicates with the keyserver helper program via pipes, which is the most efficient method. This option forces GnuPG to use temporary files to communicate. On some platforms (such as Win32 and RISC OS), this option is always enabled. +@end ifclear +@ifclear gpgtwoone @item keep-temp-files If using `use-temp-files', do not delete the temp files after using them. This option is useful to learn the keyserver communication protocol by reading the temporary files. - - @item verbose - Tell the keyserver helper program to be more verbose. This option can - be repeated multiple times to increase the verbosity level. +@end ifclear @item timeout Tell the keyserver helper program how long (in seconds) to try and @@ -1622,9 +1622,13 @@ are available for all keyserver types, some common options are: @option{--recv-keys} command as a whole. Defaults to 30 seconds. @item http-proxy=@code{value} - Set the proxy to use for HTTP and HKP keyservers. This overrides the - "http_proxy" environment variable, if any. - + Set the proxy to use for HTTP and HKP keyservers. +@ifset gpgtwoone +This overrides any proxy defined in @file{dirmngr.conf}. +@end ifset +@ifclear gpgtwoone +This overrides the "http_proxy" environment variable, if any. +@end ifclear @ifclear gpgtwoone @item max-cert-size @@ -1632,26 +1636,42 @@ are available for all keyserver types, some common options are: Defaults to 16384 bytes. @end ifclear + @item verbose +@ifset gpgtwoone +This option has no more function since GnuPG 2.1. Use the +@code{dirmngr} configuration options instead. +@end ifset +@ifclear gpgtwoone +Tell the keyserver helper program to be more verbose. This option can +be repeated multiple times to increase the verbosity level. +@end ifclear + @item debug - Turn on debug output in the keyserver helper program. Note that the - details of debug output depends on which keyserver helper program is - being used, and in turn, on any libraries that the keyserver helper - program uses internally (libcurl, openldap, etc). +@ifset gpgtwoone +This option has no more function since GnuPG 2.1. Use the +@code{dirmngr} configuration options instead. +@end ifset +@ifclear gpgtwoone +Turn on debug output in the keyserver helper program. Note that the +details of debug output depends on which keyserver helper program is +being used, and in turn, on any libraries that the keyserver helper +program uses internally (libcurl, openldap, etc). +@end ifclear @item check-cert @ifset gpgtwoone - This option has no more function since GnuPG 2.1. Use the - @code{dirmngr} configuration options instead. +This option has no more function since GnuPG 2.1. Use the +@code{dirmngr} configuration options instead. @end ifset @ifclear gpgtwoone - Enable certificate checking if the keyserver presents one (for hkps or - ldaps). Defaults to on. +Enable certificate checking if the keyserver presents one (for hkps or +ldaps). Defaults to on. @end ifclear @item ca-cert-file @ifset gpgtwoone - This option has no more function since GnuPG 2.1. Use the - @code{dirmngr} configuration options instead. +This option has no more function since GnuPG 2.1. Use the +@code{dirmngr} configuration options instead. @end ifset @ifclear gpgtwoone Provide a certificate store to override the system default. Only |