GNU Dico Manual (split by section):   Section:   Chapter:FastBack: Dicod   Up: Dicod   FastForward: Modules   Contents: Table of ContentsIndex: Concept Index

4.5 Dicod Invocation

This section summarizes dicod command line options. Options are subdivided in five categories.

4.5.1 Dicod Operation Mode

The following options select the operation mode. Only one of them can be present in the command line:


Preprocess configuration file and exit. See Preprocessor.


Run in inetd mode. See Inetd Mode.


Run unit tests for the module. Arguments following that option are parsed as follows:

modname [testargs] [-- initargs]

where modname stands for the name of the module to test, testargs are arguments to the dico_run_test function of the module, and initargs are module initialization arguments (passed to the dico_init method). Square brackets denote optional parts. Before passing to the corresponding method, both argument lists are augmented by prepending module name as the first element (with index 0).

This option implies --stderr.

Use the --load-dir (-L) option (see --load-dir), if the module is not located in one of the default load directories (see load path).

See Unit Testing, for a detailed discussion of module unit testing.


Check configuration file syntax and exit with code ‘0’ if it is OK, or with ‘78’ if there are errors. See Configuration.

4.5.2 Informational Options

The informational options cause the program to print a selected piece of information and exit. Only one informational option can be used at a time.


Show a summary of the configuration file syntax and allowed statements. See Configuration.


Display a short command line option summary and exit.


List all available command line options and exit.


Print program version and exit.

4.5.3 Modifier Options

These options modify the program behavior:


Read this configuration file instead of the default $sysconfdir/dicod.conf. See Configuration.


Operate in foreground. See Daemon Mode.

-L dir

Adds dir to the beginning of module load path. See load path, for detailed discussion.


In daemon mode, process connections in the main process, without starting subprocesses for each connection (see Daemon Mode). This means that the daemon is able to serve only one client at a time. The --single-process option is provided for debugging purposes only. Never use it in production environment.


Output the diagnostics to stderr. See –stderr.


After successful startup, output any diagnostic to syslog. This is the default.

4.5.4 Preprocessor Control

The following options control the use of preprocessor. See Preprocessor, for a detailed discussion.

-D symbol[=value]

Define the preprocessor symbol symbol. Optional value supplies the new symbol value. This option is passed to the preprocessor verbatim.

-I dir

Add the directory dir to the list of directories to be searched for preprocessor include files. See Preprocessor.


Do not use external preprocessor. See Preprocessor.


Use prog as a preprocessor for configuration file. The default preprocessor command line is m4 -s, unless overridden while configuring the package (see Default Preprocessor).

4.5.5 Debugging Options


Set debug verbosity level. The level argument is an integer ranging from ‘0’ (no debugging) to ‘100’ (maximum debugging information).


Disable transcript mode. This is the default. Use this option if you wish to temporarily disable transcript mode, enabled in the configuration file (see transcript).


Enable session transcript. This instructs dicod to log all commands it receives and all responses it sends during the session. Transcript is logged via the default logging channel (see Logging and Debugging). If logging via syslog, the ‘debug’ priority is used.

See also Session Transcript, for a description of the similar mode in dico, the client program.


Include source line information in the debugging output.


Trace parsing of the config file.


Trace the configuration file lexer.

GNU Dico Manual (split by section):   Section:   Chapter:FastBack: Dicod   Up: Dicod Invocation   FastForward: Modules   Contents: Table of ContentsIndex: Concept Index