Wydawca (split by section):   Section:   Chapter:FastBack: starting   Up: Top   FastForward: wydawca.conf   Contents: Table of ContentsIndex: Concept Index

4 How to Configure wydawca.

Upon startup, wydawca reads its settings from the configuration file wydawca.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 --config-file command line option (see config-file).

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

To test the configuration file without starting the server use --lint (-t) command line option. It causes wydawca to check configuration file for syntax errors and other inconsistencies. If no errors were detected, the program exits with code 0. Otherwise, the exit code is 78.

Using this option together with -d1 (--debug=1), causes wydawca to produce a dump of the configuration parse tree. Setting a higher debugging level (e.g. -d2 option) will additionally prefix each statement in the dump with the file location where it appeared.

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

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

Wydawca (split by section):   Section:   Chapter:FastBack: starting   Up: Top   FastForward: wydawca.conf   Contents: Table of ContentsIndex: Concept Index