---

4.3 Configuration

Upon startup, dicod reads its settings and database definitions from a configuration file dicod.conf. By default it is located in $sysconfidr (i.e., in most cases /usr/local/etc, or /etc), but an alternative location may be specified using the --config command line option (see --config).

If any errors are encountered in the configuration file, the program reports them on the standard error and exits with a non-zero status.

To test the configuration file without starting the server, use the --lint (-t) command line option. It causes dicod to check its configuration file and exit with status 0 if no errors were detected, and with status 1 otherwise.

Before parsing, the configuration file is preprocessed using m4 (see Using Preprocessor to Improve the Configuration.). To examine the preprocessed configuration without actually parsing it, use the -E command line option. To avoid preprocessing it, use the --no-preprocessor option.

The rest of this section describes configuration file syntax in detail. You can receive a concise summary of all configuration directives any time by running dicod --config-help.

• Configuration File Syntax
• Server Settings
• Authentication
• SASL Authentication
• Access Control Lists
• Security Settings
• Logging and Debugging
• Access Log
• General Settings
• Server Capabilities
• Database Modules and Handlers
• Databases
• Strategies and Default Searches
• Tuning
• Command Aliases
• Using Preprocessor to Improve the Configuration.