In this section:

Configuring the Settings

C++test  DTP Engine can be configured with settings (see Configuration Settings) that should be specified in a .properties file. The basic settings are listed in the cpptestcli.properties file shipped in [INSTALL_DIR]. 

You can also create a custom . properties file and pass it to the cpptestcli with the -settings switch. 

You can use the -settings switch multiple times to specify several .properties files. Entries with the same key will be overwritten.

cpptestcli -settings team.properties -settings project.properties -settings user.properties -config "builtin://Recommended Rules" -compiler gcc_3_4 -input cpptest.bdf

Settings Hierarchy

General settings are applied in the following order: 

1. [INSTALL_DIR]/etc/cpptestcli.properties: the base configuration file that should not be modified.
2. [INSTALL_DIR]/cpptestcli.properties: the main configuration file you can use to specify your settings that map contains templates for commonly used settings (license, reporting etc.).
3. cpptestcli.properties: for your convenience, you can store the configuration file in your home directory to overwrite settings from the [INSTALL_DIR] (for example, to ensure your settings are not affected by reinstallations or updates).
4. [WORKING_DIR]/cpptestcli.properties: for your convenience, you can store the configuration file in your working directory.
5. Custom settings passed with the command line switch -settings path/to/settings.properties (e.g., -settings ../settings.properties).
6. Custom settings passed with the command line switch -property [key=value]

All of the above settings can be overridden by custom settings that are passed with command line switches (e.g. -report, -config).

Modifying a Single Property

You can quickly modify a single property in a settings configuration file with the -property switch  without creating a dedicated configuration:

cpptestcli -property dtp.server=dtp.parasoft.com.pl -config "builtin://Recommended Rules" -compiler gcc_3_4 -input cpptest.bdf

Viewing Current Settings 

Use the -showsettings option to print the current settings and customizations, including the origin file for each configuration. 

Advanced Configuration

For advanced configuration of C++test's native code analyzers, a dedicated configuration file (in a format supported by the analyzers) can be specified with -psrc <CONFIG_FILE> switch. Parasoft Support will provide content for the advanced configuration file.