Output mode options

Option

Default

-windows

not set

Controls whether Purify opens the Viewer.

Purify opens the Viewer by default when you run an instrumented program unless you request an alternative output format using one or more of the options -log-file, -view-file or -mail-to-user.

To have Purify open the Viewer in addition to any alternative output formats, set -windows=yes.

If you set -windows=no, Purify outputs ASCII text to stderr instead of opening the Viewer. Purify interleaves error messages with the program output, and discards repeating error messages by default rather than counting them.

-log-file

not set

Set -log-file=<filename> to have Purify save ASCII output to the named file, in addition to any other output formats you requested using the -view-file or -mail-to-user option.

Purify sends the same information to the log file that you see in the Viewer. Messages are printed fully expanded. Purify does not expand source files, even when line-number and filename information is available.

Set -log-file=stderr to have Purify output ASCII text to the program's stderr stream. (Note that you cannot use  stdout  here.)

You can use conversion characters in <filename>.

If you set this option, Purify does not open the Viewer, unless you set -windows=yes.

To append output to an existing log file instead of replacing it, use the -append-logfile option

-append-logfile

no

Appends Purify output to the current log file rather than replacing it.

-view

not set

To open an empty Viewer, use:
% purify -view <program-name>.

To open an empty Viewer on a different screen, use:
% purify -view -display=<myscreen>.0 <program-name>

To open a view file in the Viewer, use:
% purify -view <program-name>.pv.
Purify opens the specified file in the Viewer, displaying the same output as when you ran the Purify'd program interactively. You do not need access to the original program.

-view-file

not set

Set -view-file=<filename>: to have Purify write compact binary data to the specified file, in addition to any other output formats you requested using the -log-file or -mail-to-user option.

Use the option -view <filename> to view the resulting file.

You can use conversion characters in <filename>.

If you set this option, Purify does not open the Viewer, unless you set -windows=yes.

-output-limit

1000000

Use with the option -log-file to restrict the size of the log file and to conserve disk space. The value of this option specifies the maximum size of the Purify log file in bytes. Purify truncates all output beyond this size.

-user-path

not set

Specifies a list of directories in which to search for programs and source code. You can specify full pathnames separated by spaces or colons (:). For example:

setenv PURIFYOPTIONS -user-path=/usr/home/prog1:/usr/home/prog2

Purify searches for the executable file from which to read the symbol table in your $PATH, then in -user-path. See also -program-name.

When searching for source code, Purify looks for the file in the full pathname specified in the debugging data, then in directories listed in -user-path, and finally in the current directory.