File: gnupg.info,  Node: Agent OPTION,  Prev: Agent GETINFO,  Up: Agent Protocol

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