Insure++ adapts to your needs by providing you a variety of customizable compile-time, run-time, reporting, and other preference settings. All settings can be customized through the Insure++ Control Panel. The most commonly-modified options can be modified using simple GUI controls. Additional options, known as psrc options, can be entered in the Advanced tab.
In this section:
Access the Control Panel
You can access the control panel in the following ways:
- Click the Insure++ Control Panel icon
- Choose Tools> Insure++ menu> Insure++ Control Panel from the main menu.
- Open the Windows Start menu and choose Programs> Insure++> Insure++ Control Panel.
Understanding and Modifying the Available Settings
You can change Insure++ options in the control panel by selecting any of the following tabs, making the appropriate changes, and clicking Apply or OK. Clicking Apply saves the changes. Clicking OK saves the changes and closes the panel.
General
The following table describes the options you can set in the General tab.
| Restore Defaults | Click Restore Defaults to restore the default settings. |
|---|---|
| Enable user-specific options | Enable this option to prompt Insure++ to write nearly all of its options to HKEY_CURRENT_USER rather than HKEY_LOCAL_MACHINE in the Windows registry. It is intended for users that have restrictive permissions preventing them from writing to HKEY_LOCAL_MACHINE. Further, it can only be turned on by a user with permissions to write to HKEY_LOCAL_MACHINE (typically an Administrator). The only options not affected by this setting are options which are intrinsic to the machine (such as node-locked licensing options, and installation options). Enable this option (by checking the check box) if you have more than one account on the same machine and you want to retain user-specific Insure++ settings for the various accounts. If you want to maintain consistency on all accounts on the machine among all executables that are debugged as system processes, DO NOT enable this option. |
| Check for uninitialized variables | Enable this option if you want Insure++ to check your code for uninitialized variables (enabled by default). |
| Inuse | Enable this option if you want Insure++ to launch the add-on runtime memory visualization tool Inuse when you run Insure++. |
| Instrument all builds in Visual C++® | Enable this option to automatically instrument all builds in Microsoft Visual C++ with Insure++. Enable this option before performing a batch build if you want to instrument all files in a batch build. This selection is not required when using the build commands on the Insure++ toolbar. |
| Automatic InsureSpy Integrated Debugging | If an application is built with Insure++, then the Insure++ debugger will automatically be invoked by the Visual C++ debugger. Enabling this option will cause Visual C++ to invoke the Insure++ debugger anytime you debug an executable from the Visual C++ GUI, whether or not that executable was built with Insure++. If your main executable is not built with Insure++, but one or more of its components (dll, ocx, and so on) is built with Insure++, enable this option to ensure that the InsureSpy Integrated Debugging is also enabled when the Insure++Debug icon is clicked on the Insure++ toolbar, regardless of whether the executable has been instrumented. For more information see InsureSpy. |
Compile
The following table describes the options you can configure in the Compile tab.
| Ignore files | Click Add and specify the names of files you do not want Insure++ to check. You can add one file per line. Select a file and click Delete to remove it from the list. |
|---|---|
| Ignore functions | Click Add and specify the names of functions you do not want Insure++ to check. You can add one function per line. Select a function and click Delete to remove it from the list. |
| Generate coverage map data | Enabling this option prompts Insure++ to generate coverage map data for TCA. Enabled by default. |
| Counting coverage | Enabling this option adds an additional TCA field that shows a count of how many times each block of code was executed in each run. Enabling this option may affect performance. |
Reports
The following table describes the options you can configure in the Reports tab.
| Send output to | Choose one of the output options:
|
|---|---|
| Summarize | Choose the types of information to include in your reports.
|
| Suppressions | Click Suppressions to open the Suppressions Control Panel. This interface enables you to set suppression preferences for error message generated by Insure++. |
| Report limit | Enable this option to specify how many times Insure++ should report the same type of error on the same line of code. When set to 1, Insure++ will only report the first error of each type on any line of code. Set to 0 to only include errors in summary reports and not at runtime. Disable to report all errors. |
Suppressions Control Panel
The Suppressions Control Panel lets you specify what types of errors you do and do not want Insure++ to report. This panel is accessible by clicking Suppressions... in the Report tab of the Insure++ Control Panel.
To create a new suppression command using the Suppression Control Panel:
- Click Insert and choose either Suppress or Unsuppress in the Action field.
- Enter or select the category of error you want to suppress or unsuppress in the Item field, for example:
BAD_FORMAT. You can also suppress and unsuppress error messages by context. See Suppressing Error Messages By Context for details. If an error code has sub-categories you want to suppress, you can disable them explicitly by listing the sub-categories in parentheses after the error name (e.g.,BAD_FORMAT (sign, compatible)).
You can also use wildcards. For example, to suppress all memory leak messages, enter
LEAK_*. You can also suppress error messages by context. For example, to suppress READ_NULL errors occurring in routines with names beginning with the characters sub, enterREAD_NULL { sub* * } In the File field, choose the file the suppression item will be enforced on. Wildcards are also supported in this field.
Add a description of the current suppression/unsuppression item in the Notes field.
The order of your suppressions matters
Insure++ reads your suppression list from top to bottom. You can move suppressions up and down the list using the Move Up and Move Down buttons.
Saving and Loading Suppression Lists
Insure++ will ask you if you want to save your suppressions to a file. This lets you re-use and/or re-edit your suppressions at a later time. To load a saved suppression list, click Browse and locate to list.
Advanced
This section describes how to configure advanced options in Insure++.
Advanced Configuration Settings for Insure++
Many Insure++ options have their own controls in the Insure++ Control Panel, but you can also use this interface to set additional Insure++ options without having to edit your Windows Registry. A complete list of options available can be found in the Configuration Options (psrc).
Click Add to insert a new option and Delete to remove an unwanted option.
Image File Execution Options
You can prompt Windows 2000 to execute a specific program under a specific debugger each time it is invoked by specifying an executable name (without a path) in the Executable field and selecting a debugger in the Debugger field. Use this feature is for debugging Windows 2000/XP Services, child processes, and other executables that require atypical invocations. For more information, see Adapting Usage to Different Environments and Needs.
This option sets the following registry key, which can also be viewed and edited in regedit:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\ CurrentVersion\Image File Execution Options
Password
The Password tab allows you enter your Insure++ password or tell Insure++ how to access License Server. For instructions on obtaining and entering your password and expiration data, see Installation and Licensing.
About
The About Tab displays which version of Insure++ you are running, as well as Parasoft contact information.
