Search Path Variables

TotalView uses the following state variables to search for executable, source, and objects files: 

  • EXECUTABLE_SEARCH_PATH: Contains a colon-separated list of the directories in which TotalView looks for executable programs.

  • OBJECT_SEARCH_PATH: Contains a colon-separated list of the directories in which TotalView looks for object files.

  • SHARED_LIBRARY_SEARCH_PATH: Contains a colon-separated list of the directories in which TotalView looks for your program's shared library files.

  • SOURCE_SEARCH_PATH: Contains a colon-separated list of the directories in which TotalView looks for source files.

You can see these variables in the TotalView's Command Line view by entering dset *PATH* to display all variables with “PATH” in the name.

These search path variables leverage additional variables described on this page, as well as a number of read-only variables described on the Search Path Read-Only Variables page.

Search Path Mapping Variables

Related to the four search path state variables are four similarly named state variables, each of which contains pairs of regular expressions and replacement strings (or mappings) separated by colons. TotalView applies these mappings to the search paths before it looks for source, object, shared library, and program files:

Syntax

The syntax for mapping strings is as follows:

+regular_exp+=+replacement+ :+regular_exp+=+replacement+

This example shows two pairs, each delimited by a colon (“:”). Each element within a pair is delimited by any character except a colon. The first character entered is the delimiter. This example uses a “+” as a delimiter. (Traditionally, forward slashes are used as delimiters but are not used here, as a forward slash is also used to separate components of a pathname. For example, /home/my_dir contains forward slashes.)

Be aware that special characters must follow standard Tcl rules and conventions. For example:

dset EXECUTABLE_SEARCH_MAPPINGS {+^/nfs/compiled/u2/(.*)$+ = +/nfs/host/u2/\1+ }

This expression applies a mapping so that a directory named /nfs/compiled/u2/project/src1 in the expanded search path becomes /nfs/host/u2/project/src1.

EXECUTABLE_PATH

The EXECUTABLE_PATH state variable contains a colon-separated list of the directories that TotalView looks in when it searches for files. It is initially undefined and is included by default in the following search path state variables:

  • EXECUTABLE_SEARCH_PATH

  • OBJECT_SEARCH_PATH

  • SOURCE_SEARCH_PATH

Do not remove EXECUTABLE_PATH from the these variables.

You can also specify the search directories for this variable by using the Preferences dialog. To learn more, see Search Path Locations.

PATH

The PATH variable contains all of the directories in your PATH variable. It is included by default in following search path state variable:

TOTALVIEW_SRC

The TOTALVIEW_SRC variable is the directory in a TotalView installation that contains the source files shipped with TotalView. It is included by default in following search path state variable:

Related Topics

Search Path Read-Only Variables

The $tree() Function