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'.