gnupg: GPGSM OPTION
5.6.12 Session options
----------------------
The standard Assuan option handler supports these options.
OPTION NAME[=VALUE]
These NAMEs are recognized:
'putenv'
Change the session's environment to be passed via gpg-agent to
Pinentry. VALUE is a string of the form '<KEY>[=[<STRING>]]'. If
only '<KEY>' is given the environment variable '<KEY>' is removed
from the session environment, if '<KEY>=' is given that environment
variable is set to the empty string, and if '<STRING>' is given it
is set to that string.
'display'
Set the session environment variable 'DISPLAY' is set to VALUE.
'ttyname'
Set the session environment variable 'GPG_TTY' is set to VALUE.
'ttytype'
Set the session environment variable 'TERM' is set to VALUE.
'lc-ctype'
Set the session environment variable 'LC_CTYPE' is set to VALUE.
'lc-messages'
Set the session environment variable 'LC_MESSAGES' is set to VALUE.
'xauthority'
Set the session environment variable 'XAUTHORITY' is set to VALUE.
'pinentry-user-data'
Set the session environment variable 'PINENTRY_USER_DATA' is set to
VALUE.
'include-certs'
This option overrides the command line option '--include-certs'. A
VALUE of -2 includes all certificates except for the root
certificate, -1 includes all certificates, 0 does not include any
certificates, 1 includes only the signers certificate and all other
positive values include up to VALUE certificates starting with the
signer cert.
'list-mode'
⇒gpgsm-cmd listkeys.
'list-to-output'
listkeys::) is written to the file descriptor set with the last
'OUTPUT' command. If VALUE is false the output is written via data
lines; this is the default.
'with-validation'
If VALUE is true for each listed certificate the validation status
is printed. This may result in the download of a CRL or the user
being asked about the trustworthiness of a root certificate. The
default is given by a command line option (⇒gpgsm-option
--with-validation).
'with-secret'
If VALUE is true certificates with a corresponding private key are
marked by the list commands.
'validation-model'
This option overrides the command line option 'validation-model'
for the session. (⇒gpgsm-option --validation-model.)
'with-key-data'
This option globally enables the command line option
'--with-key-data'. (⇒gpgsm-option --with-key-data.)
'enable-audit-log'
If VALUE is true data to write an audit log is gathered. (⇒
gpgsm-cmd getauditlog.)
'allow-pinentry-notify'
If this option is used notifications about the launch of a Pinentry
are passed back to the client.
'with-ephemeral-keys'
If VALUE is true ephemeral certificates are included in the output
of the list commands.
'no-encrypt-to'
If this option is used all keys set by the command line option
'--encrypt-to' are ignored.
'offline'
If VALUE is true or VALUE is not given all network access is
disabled for this session. This is the same as the command line
option '--disable-dirmngr'.