5.2.1 How to change the configuration
These options are used to change the configuration and are usually found
in the option 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.
- 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
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 name gpgconf.ctl in the same directory as the tool
gpgconf.exe. The root of the installation is than 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/usr/local/var/cache/gnupg
for internal cache files.
- Outputs additional information while running.
You can increase the verbosity by giving several
verbose commands to gpgsm, such as ‘-vv’.
- Change the default name of the policy file to filename.
- 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.
- Specify a dirmngr program to be used for CRL checks. The
default value is /usr/local/bin/dirmngr. This is only used as a
fallback when the environment variable
DIRMNGR_INFO is not set or
a running dirmngr cannot be connected.
- If a system wide dirmngr is running in daemon mode, first try
to connect to this one. Fallback to a pipe based server if this does
not work. Under Windows this option is ignored because the system dirmngr is
- Entirely disable the use of the Dirmngr.
- 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.
- Do not print a warning when the so called "secure memory" cannot be used.
- When running in server mode, append all logging output to file.