Miscellaneous run-time options

Options

Default

-fds

26

Specifies the default set of file descriptors used by Quantify in case they clash with the ones used by your program. To use file descriptors 57 and 58 instead of the default 26 and 27, use:

% setenv QUANTIFYOPTIONS –fds=57

 

-pure-help-max-wait

20 seconds

Enables you to set the number of seconds that the Quantify user interface waits for the Netscape browser to display the Quantify help system.

If initialization of the Netscape browser takes longer than the value set for this option, Quantify displays an error message and stops trying to open the browser.

You can also use the environment variable PURE_HELP_WAIT_MAX to increase the time allowed for initialization.

 

-program-name

argv[0]

Specifies the full pathname of the Quantify'd program if argv[0] contains an undesirable or incorrect value. This can occur if you change argv[0] in your program. For example, many programs that are invoked by a script rename their argv[0] to the name of the script.

 

-replace-path

not set

In an instrumented shared library or an instrumented "incomplete" executable (that is, an executable that references a shared library), replaces one specified library path with another.

This option is intended to make it easier to run instrumented programs generated by other teams or on other systems. It allows you set library paths in instrumented files to reflect the location of the referenced libraries on your own system. When the other team creates the instrumented program, they should use the option -lib-path-length, selecting a value to accommodate the length of the longest absolute path on your system.

To use this option for an incomplete executable, type:

% purify -replace-path <old-path> <new-path>  a.out

For an instrumented shared library, type:

% purify -replace-path <old-path> <new-path> <shared_library>_pure_23456887.sl

Specify both paths as absolute paths.

If you need to replace more than one path name in a file, run this command as many times as necessary, replacing one path name on each pass.

This option is supported only on HP-UX.

 

-user-path

not set

Specifies a colon-delimited list of directories that Quantify should search to find the program at run time. Normally, the program can be found by looking at argv[0] and your $PATH, but it is possible to execute a program not on your path.

If your program is forked by another and Quantify cannot find it to read the debug symbols, set this option to the directory where your program is stored. This option takes precedence over $PATH. Use this option if Quantify cannot find source files when attempting to display Annotated Source windows.