2 Vcsync Configuration

The program reads its configuration from the file /etc/vcsync.conf (the exact location can be changed at compilation time). Since most of the settings can be given in the command line, this file is optional and it is not considered an error if it does not exist (the warning about the fact is displayed if vcsync is run with the debugging level 1 or higher, though). An alternative configuration file can be specified using the -c (--config) command line option.

The file consists of statements terminated with semicolons. White-space characters (space, horizontal and vertical tabulation, newline, form-feed) are ignored, except as they serve to separate the tokens. Empty lines and comments are ignored. There are two kinds of comments: single-line and multi-line. Single-line comments start with ‘#’ or ‘//’ and continue to the end of the line. Multi-line or C-style comments start with the two characters ‘/*’ and continue until the first occurrence of ‘*/’.

For a detailed discussion of the configuration file syntax, Configuration file syntax. In the sections that follow, we will describe the statements understood by vcsync. Whenever a command line option exists that overrides a given configuration statement, that option will be listed with the statement in question.