Page tree

Skip to end of metadata
Go to start of metadata

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 optionsEnable 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 main executable is run under the Insure++ debugger, or simply click the Insure++Debug icon in the Visual C++ toolbar.

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 dataEnabling this option prompts Insure++ to generate coverage map data for TCA. Enabled by default.
Counting coverageEnabling 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:

  • Standard out: Sends output to stdout.
  • Standard error: Sends output to stderr.
  • Report file: Sends output to a file. Specify a location for the file in the field. Enable the Overwrite on each run option if you want Insure++ to overwrite the report file with each test run.
  • Insra: Sends the output to the Insra GUI (default). Be sure to indicate which source editor you want Insra to use for displaying and editing source files. You can choose Visual C++, Notepad, or Other. If you choose other, specify the location of your editor by entering the editor name and filename token in the field (e.g., nedit %f).
Summarize

Choose the types of information to include in your reports.

  • Bugs: Select to generate a summary report of the errors found.
  • Leaks: Select to generate a summary report of the memory leaks found.
  • Outstanding Memory: Select to generate a summary report of the outstanding allocated memory blocks.
  • Coverage: Select to generate a summary report of the code covered. Coverage summaries can be viewed with the TCA add-on for Insure++.
  • Eliminate Noise: Select to filter out any noise that your DLLs might generate. Some DLLs may contain legitimate potential overflow errors. Additionally, various service packs and O/S updates change the flag values, which are allowed in the various MS API calls. Parasoft Insure++ interfaces may not always be up to date with these changes. If you are interested in viewing these reports, disable this option.
SuppressionsClick Suppressions to open the Suppressions Control Panel. This interface enables you to set suppression preferences for error message generated by Insure++.
Report limitEnable 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:

  1. Click Insert and choose either Suppress or Unsuppress in the Action field.
  2. 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, enter READ_NULL { sub* * }

  3. In the File field, choose the file the suppression item will be enforced on. Wildcards are also supported in this field.

  4. 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.


  • No labels