gnupg: Agent OPTION
2.6.17 Set options for the session
----------------------------------
Here is a list of session options which are not yet described with other
commands. The general syntax for an Assuan option is:
OPTION KEY=VALUE
Supported KEYs are:
'agent-awareness'
This may be used to tell gpg-agent of which gpg-agent version the
client is aware of. gpg-agent uses this information to enable
features which might break older clients.
'putenv'
Change the session's environment to be used for the Pinentry.
Valid values are:
'NAME'
Delete envvar NAME
'NAME='
Set envvar NAME to the empty string
'NAME=VALUE'
Set envvar NAME to the string VALUE.
'use-cache-for-signing'
See Assuan command 'PKSIGN'.
'allow-pinentry-notify'
This does not need any value. It is used to enable the
PINENTRY_LAUNCHED inquiry.
'pinentry-mode'
This option is used to change the operation mode of the pinentry.
The following values are defined:
'ask'
This is the default mode which pops up a pinentry as needed.
'cancel'
Instead of popping up a pinentry, return the error code
'GPG_ERR_CANCELED'.
'error'
Instead of popping up a pinentry, return the error code
'GPG_ERR_NO_PIN_ENTRY'.
'loopback'
Use a loopback pinentry. This fakes a pinentry by using
inquiries back to the caller to ask for a passphrase. This
option may only be set if the agent has been configured for
that. To disable this feature use ⇒option
--no-allow-loopback-pinentry.
'cache-ttl-opt-preset'
This option sets the cache TTL for new entries created by GENKEY
and PASSWD commands when using the '--preset' option. It is not
used a default value is used.
's2k-count'
Instead of using the standard S2K count (which is computed on the
fly), the given S2K count is used for new keys or when changing the
passphrase of a key. Values below 65536 are considered to be 0.
This option is valid for the entire session or until reset to 0.
This option is useful if the key is later used on boxes which are
either much slower or faster than the actual box.
'pretend-request-origin'
This option switches the connection into a restricted mode which
handles all further commands in the same way as they would be
handled when originating from the extra or browser socket. Note
that this option is not available in the restricted mode. Valid
values for this option are:
'none'
'local'
This is a NOP and leaves the connection in the standard way.
'remote'
Pretend to come from a remote origin in the same way as
connections from the '--extra-socket'.
'browser'
Pretend to come from a local web browser in the same way as
connections from the '--browser-socket'.