Previous: Return information about the process, Up: Agent’s Assuan Protocol [Contents][Index]

#### 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`.

Previous: Return information about the process, Up: Agent’s Assuan Protocol [Contents][Index]