Using Quantify options

You can specify Quantify options:

Any options specified in environment variables take precedence over options specified on the link line.

Quantify can also collect performance data for Java applications running on a Solaris SPARC 32-bit Java virtual machine (JVM). For information about using Quantify options with Java code, click

Syntax

Option types

Quantify supports three types of options: boolean, string, and integer.

Specifying options in environment variables

You can specify any Quantify option in the QUANTIFYOPTIONS and PUREOPTIONS environment variables. Values in PUREOPTIONS apply to Quantify, PureCoverage, and Purify software products. The values specified in QUANTIFYOPTIONS take precedence over PUREOPTIONS.

Quantify applies build-time options specified in environment variables when a Quantify'd application is built. Any build-time options on the link line override environment variables.

Quantify applies run-time options specified in environment variables when you run the Quantify'd program. The environment values in force when you run the program override any defaults specified on the link line.

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

csh

% setenv QUANTIFYOPTIONS "-log-file=new \
$QUANTIFYOPTIONS"

sh, ksh

$ QUANTIFYOPTIONS="-log-file=new \
$QUANTIFYOPTIONS"; exportQUANTIFYOPTIONS

Setting site-wide options

You can use the PUREOPTIONS environment variable to set options that apply to Quantify, PureCoverage, and Purify software products.

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 PUREOPTIONS environment variable to apply to all users.

Specifying options on the link line

You can specify any Quantify option on the link line. For example:

quantify -cache-dir=$HOME/qcache -always-use-cache-dir $CC ...

Quantify applies build-time options to the Quantify build command being run.

Quantify builds run-time options into the executable so that they become the default values for the Quantify'd executable. This is a convenient way to build a program with nonstandard default values for run-time options. For example, the link line:

% quantify -collection-granularity=function \
  -record-system-calls=no cc ...

instructs Quantify to instrument the program at build time to collect data only at the function level, and at run time to avoid collecting system call data.

Note: