OS Manuals

/usr/bin/dirmngr

GNU Privacy Guard 2 - network certificate management service

From gnupg-fips-dirmngr 2.4.9-r13 (enterprise-packages), captured 2026-11-08 by running dirmngr --help (exit 0). permalink

dirmngr[2]: out of core handler ignored in FIPS mode
dirmngr (GnuPG) 2.4.9
Copyright (C) 2025 g10 Code GmbH
License GNU GPL-3.0-or-later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Syntax: dirmngr [options] [command [args]]
Keyserver, CRL, and OCSP access for GnuPG

Commands:

     --server                     run in server mode (foreground)
     --daemon                     run in daemon mode (background)
     --list-crls                  list the contents of the CRL cache
     --load-crl FILE              load CRL from FILE into cache
     --fetch-crl URL              fetch a CRL from URL
     --shutdown                   shutdown the dirmngr
     --flush                      flush the cache

Options used for startup:
     --no-detach                  do not detach from the console
 -s, --sh                         sh-style command output
 -c, --csh                        csh-style command output
     --options FILE               read options from FILE

Options controlling the diagnostic output:
 -v, --verbose                    verbose
 -q, --quiet                      be somewhat more quiet
     --debug-level LEVEL          set the debugging level to LEVEL
     --log-file FILE              write server mode logs to FILE

Options controlling the configuration:
     --allow-version-check        allow online software version check
     --max-replies N              do not return more than N items in one query

Network related options:
     --use-tor                    route all network traffic via Tor

Configuration for HTTP servers:
     --disable-http               inhibit the use of HTTP
     --ignore-http-dp             ignore HTTP CRL distribution points
     --http-proxy URL             redirect all HTTP requests to URL
     --honor-http-proxy           use system's HTTP proxy setting

Configuration for OpenPGP servers:
     --keyserver URL              use keyserver at URL
     --hkp-cacert FILE            use the CA certificates in FILE for HKP over TLS

Configuration for X.509 servers:
     --disable-ldap               inhibit the use of LDAP
     --ignore-ldap-dp             ignore LDAP CRL distribution points
     --ldap-proxy HOST            use HOST for LDAP queries
     --only-ldap-proxy            do not use fallback hosts with --ldap-proxy
     --ldapserver SPEC            use this keyserver to lookup keys
     --ldapserverlist-file FILE   read LDAP server list from FILE
     --add-servers                add new servers discovered in CRL distribution points to serverlist
     --ldaptimeout N              set LDAP timeout to N seconds

Configuration for OCSP:
     --allow-ocsp                 allow sending OCSP requests
     --ignore-ocsp-service-url    ignore certificate contained OCSP service URLs
     --ocsp-responder URL         use OCSP responder at URL
     --ocsp-signer FPR            OCSP response signed by FPR

Other options:
     --force                      force loading of outdated CRLs

(See the "info" manual for a complete listing of all commands and options)

Please report bugs to <https://bugs.gnupg.org>.
Options (61)
OptionDescriptionSource
--serverrun in server mode (foreground)help
--daemonrun in daemon mode (background)help
--list-crlslist the contents of the CRL cachehelp
--load-crl FILEload CRL from FILE into cachehelp
--fetch-crl URLfetch a CRL from URLhelp
--shutdownshutdown the dirmngrhelp
--flushflush the cachehelp
--no-detachdo not detach from the consolehelp
-s, --shsh-style command outputhelp + man + man
-c, --cshFormat the info output in daemon mode for use with the standard Bourne shell respective the C-shell.help + man + man
--options FILEReads configuration from file instead of from the default per-user configuration file.help + man
-v, --verboseOutputs additional information while running.help + man + man
-q, --quietbe somewhat more quiethelp
--debug-level LEVELSelect the debug level for investigating problems.help + man
--log-file FILEAppend all logging output to file.help + man
--allow-version-checkAllow Dirmngr to connect to https://versions.gnupg.org to get the list of current software versions.help + man
--max-replies NDo not return more that n items in one query.help + man
--use-torroute all network traffic via Torhelp + man
--disable-httpDisable the use of HTTP to fetch CRLs.help + man
--ignore-http-dpWhen looking for the location of a CRL, the to be tested certificate usually contains so called CRL Distribution Point (DP) entries which are URLs describing the way to access the CRL.help + man
--http-proxy URLredirect all HTTP requests to URLhelp
--honor-http-proxyIf the environment variable ‘http_proxy’ has been set, use its value to access HTTP servers.help + man
--keyserver URLUse name as your keyserver.help + man
--hkp-cacert FILEUse the root certificates in file for verification of the TLS certificates used with hkps (keyserver access over TLS).help + man
--disable-ldapEntirely disables the use of LDAP.help + man
--ignore-ldap-dpThis is similar to --ignore-http-dp but ignores entries using the LDAP scheme.help + man
--ldap-proxy HOSTuse HOST for LDAP querieshelp
--only-ldap-proxyNever use anything else but the LDAP "proxy" as configured with --ldap-proxy.help + man
--ldapserver SPECThis is an alternative way to specify LDAP servers for CRL and X.509 certificate retrieval.help + man
--ldapserverlist-file FILERead the list of LDAP servers to consult for CRLs and X.509 certificates from file instead of the default per-user ldap server list file.help + man
--add-serversThis option makes dirmngr add any servers it discovers when validating certificates against CRLs to the internal list of servers to consult for certificates and CRLs.help + man
--ldaptimeout NSpecify the number of seconds to wait for an LDAP query before timing out.help + man
--allow-ocspThis option enables OCSP support if requested by the client.help + man
--ignore-ocsp-service-urlIgnore all OCSP URLs contained in the certificate.help + man
--ocsp-responder URLUse url as the default OCSP Responder if the certificate does not contain information about an assigned responder.help + man
--ocsp-signer FPRUse the certificate with the fingerprint fpr to check the responses of the default OCSP Responder.help + man
--forceEnabling this option forces loading of expired CRLs;help + man
--homedir dirSet the name of the home directory to dir. (in the manual page but not in --help)man
--compatibility-flags flagsSet compatibility flags to work around certain problems or to emulate bugs. (in the manual page but not in --help)man
--faked-system-time epochThis option is only useful for testing; (in the manual page but not in --help)man
--debug flagsSet debug flags. (in the manual page but not in --help)man
--debug-allSame as --debug=0xffffffff (in the manual page but not in --help)man
--tls-debug levelEnable debugging of the TLS layer at level. (in the manual page but not in --help)man
--debug-wait nWhen running in server mode, wait n seconds before entering the actual processing loop and print the pid. (in the manual page but not in --help)man
--disable-check-own-socketOn some platforms dirmngr is able to detect the removal of its socket file and shutdown itself. (in the manual page but not in --help)man
--no-use-torThe option --use-tor switches Dirmngr and thus GnuPG into Tor mode'' to route all network access via Tor (an anonymity network). (in the manual page but not in --help)man
--standard-resolverThis option forces the use of the system's standard DNS resolver code. (in the manual page but not in --help)man
--recursive-resolverWhen possible use a recursive resolver instead of a stub resolver. (in the manual page but not in --help)man
--resolver-timeout nSet the timeout for the DNS resolver to N seconds. (in the manual page but not in --help)man
--connect-timeout n (in the manual page but not in --help)man
--connect-quick-timeout nSet the timeout for HTTP and generic TCP connection attempts to N seconds. (in the manual page but not in --help)man
--listen-backlog nSet the size of the queue for pending connections. (in the manual page but not in --help)man
--nameserver ipaddrIn Tor mode'' Dirmngr uses a public resolver via Tor to resolve DNS names. (in the manual page but not in --help)man
--disable-ipv4 (in the manual page but not in --help)man
--disable-ipv6Disable the use of all IPv4 or IPv6 addresses. (in the manual page but not in --help)man
--ocsp-max-clock-skew nThe number of seconds a skew between the OCSP responder and them local clock is accepted. (in the manual page but not in --help)man
--ocsp-max-period nSeconds a response is at maximum considered valid after the time given in the thisUpdate field. (in the manual page but not in --help)man
--ocsp-current-period nThe number of seconds an OCSP response is considered valid after the time given in the NEXT_UPDATE datum. (in the manual page but not in --help)man
--ignore-cert-extension oidAdd oid to the list of ignored certificate extensions. (in the manual page but not in --help)man
--ignore-crl-extension oidAdd oid to the list of ignored CRL extensions. (in the manual page but not in --help)man
--ignore-cert fpr|fileEntirely ignore certificates with the fingerprint fpr. (in the manual page but not in --help)man
Examples (3) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.