syncdat Configuration File

All of syncdat's settings can be controlled using command line options.  You can also use configuration files to specify commonly used settings.

Locations and Load Order

On startup, syncdat will attempt to load configuration information from three locations: a system-wide file, a home directory file, or a path given with command line option -f.

Mac / Unix Windows
System /etc/syncdat.cf %SystemRoot%\syncdat.cf
Home $HOME/.syncdat.cf %AppData%\DEI\syncdat.cf
-f <path> <path> <path>

Settings will be honored in the following increasing precedence: built-in defaults, system configuration file, home configuration file, command line configuration file, then command line options.

You can disable all configuration files by using a blank path with -f.  This ensures that only built-in defaults and command line options are used.  For example:

syncdat -f "" ...

Note that if the "-f" option is not empty, then the settings in the specified file will be merged with those of the System and Home configurations as described above.  Only a blank "-f" prevents those configurations from being loaded.

Format

Each line in a configuration file may consist of up to 1022 bytes of text.  For Windows systems, the text must be plain ASCII and lines should end with CR-LF.  For all other systems, the text should be UTF-8 (no BOM) and lines should end with LF.

A line whose first byte is a hash (#) character or which consists entirely of spaces and tabs is ignored.  Leading spaces and tabs on an otherwise valid line are skipped.  Valid lines have one of the following formats:

<variable>=<value> <variable> <value>

The second form ignores any leading white space in <value>.  Variable names are not case sensitive.  See the enclosed syncdat.cf file for an example.

Configuration variables, along with their corresponding command line options, are described in the Options section.

A configuration file must contain the following line to work with this version of syncdat:

SyncDatConfigVersion 1

Do not change or remove that value as it defines the format of the file and servedat may reject or incorrectly parse the file if it has a different number.

Values are set in the order they are read.  If you are enabling diagnostics, it is recommended that you do this as early as possible so that you can see diagnostics for the settings that follow.