Selecting Instrumentation Levels for Specific Modules (Error Detection)

Related Topics

 

1.    Open the Default Settings or Executable Settings dialog box, or click Settings in the Run Program dialog box.

2.    Select the PowerCheck tab.

3.    In the Modules to Instrument group, click Configure....

4.    Select a module in the Module list.

5.    Select whether to include the path, if possible, with the file names in the Module list.

6.    Select whether to use default, precise, or minimal error-checking instrumentation for the selected module.

7.    If you are collecting coverage data, select whether to use default, line, or function coverage-monitoring instrumentation for the selected module, or to exclude it.

8.    Select whether to clear the cache directory.

9.    Click OK.

Notes:

§      Use Shift + click to select a range of modules, and Ctrl + click to select non-adjacent modules, or toggle the selection of an individual line.

§      Click images\modnew.gif to open the Select Module dialog box for adding modules to the Module list. For example, you can add explicitly loaded modules (for example, LoadLibrary files) that Purify isn't aware of until run time.

§      Click images\moddel.gif to remove a module from the Module list. If you remove any modules that the current program requires to run, Purify will instrument those modules using the default instrumentation.

§      Click images\modreset.gif to reset all instrumentation levels to Purify's defaults.

§      In the Module list, any instrumentation level enclosed in parentheses is the default level, based on Purify's defaults and on the defaults specified in the PowerCheck tab in the settings dialog boxes.

§      By default, Purify uses precise instrumentation for error checking on certain sets of modules; for example, any DLL whose name starts with Mfc*d.dll.

§      By default, Purify excludes certain modules in the Windows directories from coverage instrumentation. Some of these modules, known as system modules, are always excluded and you cannot change their coverage level. The coverage level for these modules appears as (System).

§      If the module you selected in the Module list is already instrumented and saved in the cache directory, and you change the instrumentation level, Purify automatically deletes the cached version and reinstruments the file the next time you run the program.

§      Use the Modules tab in the Properties dialog box to see exactly how Purify instrumented each module.

§      The Module list identifies programs for which relocation data is not available by adding (No Relocs). The availability of relocation data, as well as debug line data and symbol data, affects the level at which Purify can perform instrumentation. For more information, click images\shortcut.gif

(C) Copyright IBM Corporation 1992, 2010.