The Search Path and TotalView Built-in Functions

 

TotalView has two built-in functions that can help you set search paths. Both take a string argument and return a mapped string (MS). If the MS does not name a directory, no directories are searched.

$tree(string)

If the MS names a directory, TotalView search all the directories contained in the MS, including the MS itself.

$link(string)

If the MS names a directory and the file is not in the MS or the file is in the MS but it is not a symbolic link, the function returns no values.

Since you can have multiple levels of symbolic links, TotalView keeps following links until it finds the actual executable file. It will then look in this directory for your file. If the file isn't there, TotalView backs up the chain of links until either it finds the file or determines that it cannot find it.

The following figure shows the Sources tab from within the File Searching dialog box. In it, you will see five items. TotalView will look in each of these places searching for your source files. The $link function also tells TotalView to look for symbolic links in the directories named in the EXECUTABLE_DIRECTORY variable. (Future tips will discuss these directories.However, you can find the information you need in the online help.)


You can find tips that we've already sent out in our Tip Archive

Help us improve these tips!