Using PureCoverage options

You can specify PureCoverage options:

• In the environment variables PURECOVOPTIONS or PUREOPTIONS

• On the link line

• On the command line with a PureCoverage mode option: purecov -view, purecov -merge, or purecov -export

This is also the order of precedence (environment variable, link line, mode option) in which PureCoverage processes the options.

Note: PureCoverage can also collect coverage data for Java applications running on a Solaris SPARC 32-bit Java virtual machine (JVM); for information about PureCoverage options relevant to Java code, click

Syntax

• PureCoverage options must begin with a hyphen; for example, -force-merge.

• PureCoverage ignores case, hyphens, and underscores in the option name. For example, the option -force-merge is equivalent to -FORCE_MERGE and -ForceMerge.

• For options that take a list of directories, use spaces or colons (:) to separate directory names.

• Many options have default values. You can override these values using the syntax -option_name[=[value]]

• Do not use a space on either side of an equal sign (=).

Option types

PureCoverage supports two types of options:   string and boolean:

• String options can be a string of any kind. If you specify an option without an explicit value, the value is cleared.
  
  For example, the option -log-file=./purecovout routes PureCoverage messages to the file purecovout in the current directory. The option -log-file without a value clears any specification of a logfile.

• Boolean options take the values yes or no.

• The value yes applies if you specify an option but no value. For example, -force-merge is equivalent to -force-merge=yes.

• The default value for an option applies if you do not specify the option at all.

• For the -apply-adjustments option, you must specify -apply-adjustments=no to turn the option off.
   

Specifying options in environment variables

You can specify PureCoverage options in the environment variables PURECOVOPTIONS or PUREOPTIONS. Values in PUREOPTIONS apply to PureCoverage, Purify, and Quantify software products. Values in PURECOVOPTIONS take precedence over values in PUREOPTIONS.

PureCoverage applies build-time options specified in environment variables when it builds instrumented applications. Any build-time options on the link line override build-time environment variables.

PureCoverage applies run-time options specified in environment variables when you run instrumented applications. The run-time environment values in force when you run the program override any values specified on the link line.

If an option is specified more than once in an environment variable, PureCoverage applies the first value. To add an overriding value for the -log-file option without changing other options specified, use a command like:

csh % setenv PURECOVOPTIONS "-log-file=new \
   $PURECOVOPTIONS"
 ksh $ export PURECOVOPTIONS="-log-file=new \
    $PURECOVOPTIONS"

For information about specifying options when you are using Purify with PureCoverage, click

PUREOPTIONS

You can use the PUREOPTIONS environment variable to set options that apply to all users of PureCoverage, Purify, and Quantify software products. PUREOPTIONS is convenient for specifying defaults that apply to all three applications.

For example, if your site has a central shared file that is sourced by all users' .cshrc or .profile files, you can set cache-dir=/alternate/dir in the environment variable PUREOPTIONS to apply to all users.

Specifying options on the link line

You can specify build-time and run-time options on the link line. For example:

% purecov -cache-dir=${HOME}/pcache \
 -always-use-cache-dir $CC ...

Build-time options apply to the PureCoverage build command being run.

Run-time options are built into the executable and become the default values for the instrumented executable. This provides a convenient way to build a program with nonstandard default values for run-time options. For example:

% purecov -force-merge $CC ...

Notes:

• To make sure that run-time options you specify remain in effect whenever the executable is run, use the -ignore-run-time-environment option at build time.

• To find out what options are built into a PureCoverage instrumented program, use:
  
  % <purecovhome>/purecov_what_options <program name>

• When using the -view, -export, -merge, or -extract mode options, you can specify additional options on the command line. These options override any options in the environment variables PURECOVOPTIONS or PUREOPTIONS.