The SWC-DB Configuration-Files with extension .cfg (etc/swcdb/*.cfg)

SWC-DB by default for the configuration files, relatively to the installation-prefix, use the folder etc/swcdb/. The default path for configuration files is a run-time configurable property swc.cfg.path argv for using with swcdbProgram ‘args', the swcdbProgram --help; will indicate whether it is optional.

The file Format

The file is a single propery a line and tree-wise grouping format. The structure of property is a key=value whereas if key is delimmited with dot(.) k.e.y=value each dot is a sub-grouping to it's parent. Duplicate keys with different values, value function of single-value will overwrite it's earlier value while value of many-values function will have a list of values to the key in the given order of the configurations.

Single Key Propery

unique key:

NameOfProp.1.name=value
NameOfProp.2.name=value

mulit-value key:

NameOfProp.3.name=value_1
NameOfProp.3.name=value_2

Grouped Key Properties

[NameOfProp]
1.name=value
2.name=value
3.name=value_1
3.name=value_2
[NameOfProp=end]

Property Value

The value of a property defaults to type String, the available specialized value types by function are:

• single-value [ BOOL, UINT8, UINT16, INT32, INT64, DOUBLE, STRING, ENUM]
• many-values [ STRINGS, INT64S, DOUBLES]
• guarded-value/s [ G_BOOL, G_UINT8, G_INT32, G_ENUM, G_STRINGS ]

The file with extended extension (.dyn.cfg)

Additionally to the .cfg configuration filename there are filenames with extended extension of dynamic type .dyn.cfg. These files are designated for use with value of function guarded-value/s which are allowed for reload of configurations at swcdbPrograms run-time.

The Roles and cfg filename

The configuration files are changeable by configuration properties applied to a program, while by default-setup these filenames cfg properties structured on corresponding role/service/program naming.

The following cfg-files for roles are used: