View > Lookup Variable

Use this dialog box to search for a variable, function, or file in your program.

If you are searching for a variable, TotalView displays the variable’s information in a Variable Window.

If you are searching for a function or file, TotalView will display it in the Source Pane. If it is not found, TotalView uses a simple spelling correction procedure to search for a function with a similar name.

Enter the name of the function or file that TotalView will search for.

Searches for a function or file. TotalView assumes that you are typing a function name. If it cannot find the function, it assumes that what you typed was a file’s name and will search for it.

The source for the function is placed into the Source Pane using a Dive operation. Consequently, you can return to the previous contents of the Source Pane by clicking on the < Undive icon in the Source Pane title bar.

Searches for a local, static, or global variable in your program’s symbol table. If you specify a local variable, it must be in the current stack frame. If you specify a pair of addresses instead of a name, TotalView displays the data from the first address to the second (in hex).

The Preferred scope field shows the place from which TotalView begins looking.

If a local and global variable have the same name, TotalView displays the local variable. If TotalView cannot find the local variable, it next checks for a global or static variable.

You cannot tell TotalView which instance of a global or static variable to display. This means that this command cannot locate and display more than one variable with the same name.

If you enter a number, TotalView will display the value at that address as a $void. If you enter two numbers separated by a comma, TotalView displays all locations from the first value to the second as an array of type $void.

After a Variable Window appears, you can edit the type field to show the data in a different way. If you enter an expression, the data type is based on the type of the expression. Similarly, if you enter a cast, the value shown is the result of the cast. Casting is discussed in the TotalView Users Guide.