Dico

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:

-E

Preprocess configuration file and exit. See Preprocessor.

-i

--inetd

Run in inetd mode. See Inetd Mode.

-r

--runtest

--test

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.

-t

--lint

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.

--config-help

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

-h

--help

Display a short command line option summary and exit.

--usage

List all available command line options and exit.

--version

Print program version and exit.

4.5.3 Modifier Options

These options modify the program behavior:

--config=file

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

-f

--foreground

Operate in foreground. See Daemon Mode.

-L dir

--load-dir=dir

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

-s

--single-process

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.

--stderr

Output the diagnostics to stderr. See –stderr.

--syslog

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.

--define=symbol[=value]

-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

--include-dir=dir

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

--no-preprocessor

Do not use external preprocessor. See Preprocessor.

--preprocessor=prog

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

-x

--debug=level

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

--no-transcript

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

-T

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

--source-info

Include source line information in the debugging output.

--trace-grammar

Trace parsing of the config file.

--trace-lex

Trace the configuration file lexer.