KCALDAV.CONF(5) File Formats Manual KCALDAV.CONF(5)

kcaldav.confkcaldav configuration

kcaldav.conf

The kcaldav.conf file specifies run-time configuration for kcaldav(8). Its location relative to the web server root is set at compile-time. If not set, or the file does not exist, system defaults are used.

The file is designed to be human readable and contains a list of keywords with values that represent run-time configuration.

A keyword and its value must appear on a single line. The keyword and value are separated by the equal sign (=). White-space at the start, end, and around the equal sign are stripped. A hash mark (#) in the file indicates the beginning of a comment; subsequent characters up to the end of the line are not interpereted by the routines that read the file. If the hash mark is preceded by a backslash (\), the backslash is stripped from input, but the hash mark is retained. Blank lines (even if containing spaces) are ignored. It is an error to specify unknown keywords or keywords without a equal sign.

The configuration options are:

File for writing log messages. This must already exist and be writable by the kcaldav(8) process. If specified as an empty string or not specified, the default is writing log messages to stderr.
A non-negative number indicating log level. Zero, the default, outputs only warning and error messages. One additionally outputs informational messages. Two additionally outputs database debug messages. Three additionally outputs network debug messages.

A reasonable default configuration is as follows:

# Instead of logging to stderr (usually stored in the web server's
# error.log), log to a specific file relative to the web server
# chroot.
logfile=/logs/kcaldav.log

# Set debug=1 to also output informational messages.
# Set debug=2 to also output database debug messages.
# Set debug=3 to also output network debug messages.
debug=1

For submitting bug reports, debug should be set to 3.

kcaldav(8)

November 26, 2023 OpenBSD 7.4