gnupg: Configuration Options
5.2.1 How to change the configuration
-------------------------------------
These options are used to change the configuration and are usually found
in the option file.
'--options FILE'
Reads configuration from FILE instead of from the default per-user
configuration file. The default configuration file is named
'gpgsm.conf' and expected in the '.gnupg' directory directly below
the home directory of the user.
'--homedir DIR'
Set the name of the home directory to DIR. If this option is not
used, the home directory defaults to '~/.gnupg'. It is only
recognized when given on the command line. It also overrides any
home directory stated through the environment variable 'GNUPGHOME'
or (on Windows systems) by means of the Registry entry
HKCU\SOFTWARE\GNU\GNUPG:HOMEDIR.
On Windows systems it is possible to install GnuPG as a portable
application. In this case only this command line option is
considered, all other ways to set a home directory are ignored.
To install GnuPG as a portable application under Windows, create an
empty file named 'gpgconf.ctl' in the same directory as the tool
'gpgconf.exe'. The root of the installation is then that
directory; or, if 'gpgconf.exe' has been installed directly below a
directory named 'bin', its parent directory. You also need to make
sure that the following directories exist and are writable:
'ROOT/home' for the GnuPG home and 'ROOT/var/cache/gnupg' for
internal cache files.
'-v'
'--verbose'
Outputs additional information while running. You can increase the
verbosity by giving several verbose commands to 'gpgsm', such as
'-vv'.
'--policy-file FILENAME'
Change the default name of the policy file to FILENAME.
'--agent-program FILE'
Specify an agent program to be used for secret key operations. The
default value is determined by running the command 'gpgconf'. Note
that the pipe symbol ('|') is used for a regression test suite hack
and may thus not be used in the file name.
'--dirmngr-program FILE'
Specify a dirmngr program to be used for CRL checks. The default
value is '/usr/bin/dirmngr'.
'--prefer-system-dirmngr'
This option is obsolete and ignored.
'--disable-dirmngr'
Entirely disable the use of the Dirmngr.
'--no-autostart'
Do not start the gpg-agent or the dirmngr if it has not yet been
started and its service is required. This option is mostly useful
on machines where the connection to gpg-agent has been redirected
to another machines. If dirmngr is required on the remote machine,
it may be started manually using 'gpgconf --launch dirmngr'.
'--no-secmem-warning'
Do not print a warning when the so called "secure memory" cannot be
used.
'--log-file FILE'
When running in server mode, append all logging output to FILE.
Use 'socket://' to log to socket.
Info Catalog
gnupg: GPGSM Options
gnupg: Certificate Options