Next: , Up: Option Summary   [Contents][Index]

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.


Outputs additional information while running. You can increase the verbosity by giving several verbose commands to gpgsm, such as ‘-vv’.

--keyserver string

This is a deprecated option. It was used to add an LDAP server to use for X.509 certificate and CRL lookup. The alias --ldapserver existed from version 2.2.28 to 2.2.33 and 2.3.2 to 2.3.4 but is now entirely ignored.

LDAP servers must be given in the configuration for dirmngr.

--policy-file filename

Change the default name of the policy file to filename. The default name is policies.txt.

--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/local/bin/dirmngr.


This option is obsolete and ignored.


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.

--log-file file

When running in server mode, append all logging output to file. Use socket:// to log to socket.


Prefix all log output with a timestamp even if no log file is used.

Next: Certificate related options, Up: Option Summary   [Contents][Index]