File: gnupg.info,  Node: Configuration Options,  Next: Certificate Options,  Up: GPGSM 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.

'-v'
'--verbose'
     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'.

'--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.

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