ARGS(dpmid)
Contains the arguments to be passed the next time the process starts, with TotalView ID dpid.
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
Contains the value for the “stop_when_done” property for newly created action points. This property defines what else to stop when a barrier point is satisfied or a thread encounters this action point. You can also set this value using the When barrier hit, stop value in the Action Points Page of the File > Preferences dialog box. The values are:
Stops all processes in a thread’s control group when a thread reaches a barrier created using this default.
Stops the process in which the thread is running when a thread reaches a barrier created using this default.
|
Permitted Values:
|
|
Default:
|
BARRIER_STOP_WHEN_DONE
Contains the default value used when a barrier point is satisfied. You can also set this value using the –stop_when_done command-line option or the When barrier done, stop value in the Action Points Page of the File > Preferences dialog box. The values are:
Stops only the threads in the satisfaction set; other threads are not affected. For process barriers, there is no difference between process and none.
|
Permitted Values:
|
|
Default:
|
CGROUP(dpid)
Contains the control group for the process with the TotalView ID dpid. Setting this variable moves process dpid into a different control group. For example, the following command moves process 3 into the same group as process 1:
|
Permitted Values:
|
|
Default:
|
Enables some Emacs-like commands for use when editing text in the CLI. These editing commands are always available in the CLI window of the TotalView GUI. However, they are available only in the stand-alone CLI if the terminal in which it is running supports cursor positioning and clear-to-end-of-line. The commands you can use are:
^A: Moves the cursor to the beginning of the line
^B: Moves the cursor one character backward
^D: Deletes the character to the right of cursor
^E: Moves the cursor to the end of the line
^F: Moves the cursor one character forward
^K: Deletes all text to the end of line
^N: Retrieves the next entered command (only works after ^P)
^P: Retrieves the previously entered command
^R or ^L: Redraws the line
^U: Deletes all text from the cursor to the beginning of the line
Rubout or Backspace: Deletes the character to the left of the cursor
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
. (dot)
|
Contains pairs of regular expressions and replacement and replacement strings—these replacements are called mappings—separated by colons. TotalView applies these mappings to the search paths before it looks for source, object, and program files.
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.)
dset EXECUTABLE_SEARCH_MAPPINGS
{+^/nfs/compiled/u2/(.*)$+ = +/nfs/host/u2/\1+ }
{+^/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.
|
Default:
|
Contains a list of paths, separated by a colon, to search for executables. For information, see “Setting Search Paths Using TotalView Variables” in the online help.
|
Permitted Values:
|
|
Default:
|
GROUP(gid)
The gid is a simple number for most groups. In contrast, a lockstep group’s ID number is of the form pid.tid. Thus, GROUP(2.3) contains the lockstep group for thread 3 in process 2. Note, however, that the CLI does not display lockstep groups when you use dset with no arguments because they are hidden variables.
|
Permitted Values:
|
A Tcl array of lists indexed by the group ID. Each entry contains the members of one group.
|
|
Default:
|
Contains a list of all TotalView groups IDs. Lockstep groups are not contained in this list. This is a read-only value and cannot be set.
|
Permitted Values:
|
Defines the number of lines shown before the CLI stops printing information and displays its more prompt. The following values have special meaning:
No more processing occurs, and the printing does not stop when the screen fills with data.
The CLI uses the tty settings to determine the number of lines to display. This may not work in all cases. For example, Emacs sets the tty value to 0. If AUTO works improperly, you need to explicitly set a value.
|
Permitted Values:
|
|
Default:
|
Defines the maximum number of levels that the dwhere command displays.
|
Permitted Values:
|
|
Default:
|
Defines the number of lines that the dlist command displays.
|
Permitted Values:
|
|
Default:
|
Contains pairs of regular expressions and replacement and replacement strings (called mappings) separated by colons. TotalView applies these mappings to the search paths when searching for source, object, and program files. For more information, see EXECUTABLE_SEARCH_MAPPINGS.
|
Default:
|
Contains a list of paths separated by a colon to search for your program’s object files. For information, see “Search Path Variables That You Can Set” in the online help.
|
Permitted Values:
|
|
Default:
|
${COMPILATION_DIRECTORY):
${EXECUTABLE_PATH}: ${EXECUTABLE_DIRECTORY}: $links{${EXECUTABLE_DIRECTORY}}: .:${TOTALVIEW_SRC} |
PROCESS(dpid)
Contains a list of information associated with a dpid. This is a read-only value and cannot be set.
|
Permitted Values:
|
|
Default:
|
Defines the CLI prompt. Any information within brackets ([ ]) is assumed to be a Tcl command, so therefore evaluated before the prompt string is created.
|
Permitted Values:
|
Any string. To access the value of PTSET, place the variable within brackets; that is, [dset PTSET].
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
SGROUP(pid)
Contains the group ID of the share group for process pid. The share group is determined by the control group for the process and the executable associated with this process. You cannot directly modify this group.
|
Permitted Values:
|
|
Default:
|
SHARE_ACTION_POINT
Indicates the scope for newly created action points. In the CLI, this is the dbarrier, dbreak, and dwatch commands. If this boolean value is true, newly created action point are shared across the group; if false, a newly created action point is active only in the process in which it is set.
As an alternative to setting this variable, you can select the Plant in share group check box in the Action Points Page in the File > Preferences dialog box. To override this value in the GUI, use the Plant in share group checkbox in the Action Point > Properties dialog box.
|
Permitted Values:
|
|
Default:
|
Contains pairs of regular expressions and replacement strings (mappings), separated by colons. TotalView applies these mappings to the search paths before it looks for shared library files.
|
Default:
|
Contains a list of paths, each separated by a colon, to search for your program’s shared library files.
|
Permitted Values:
|
|
Default:
|
Contains pairs of regular expressions and replacement strings (mappings) separated by colons. TotalView applies these mappings to the search paths before it looks for source, object, and program files. For more information, see EXECUTABLE_SEARCH_MAPPINGS.
|
Default:
|
Contains a list of paths, separated by a colon, to search for your program’s source files. For information, see “Search Path Variables That You Can Set” in the online help.
|
Permitted Values:
|
|
Default:
|
${COMPILATION_DIRECTORY}:
${EXECUTABLE_PATH}: ${EXECUTABLE_DIRECTORY}: ${links{${EXECUTABLE_DIRECTORY}): .:${TOTALVIEW_SRC} |
Indicates a default property for newly created action points, defining what else to stop when this action point is encountered
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
A positive number. A value of –1 indicates that the CLI does not simulate tab expansion.
|
|
Default:
|
THREADS(pid)
Contains a list of all threads in the process pid, in the form {pid.1 pid.2 ...}. This is a read-only variable and cannot be set.
|
Permitted Values:
|
|
Default:
|
TOTALVIEW_ROOT_PATH
Names the directory containing the TotalView executable. This is a read-only variable and cannot be set. This variable is exported as TVROOT, and can be used in launch strings.
|
Permitted Values:
|
TOTALVIEW_TCLLIB_PATH
|
Permitted Values:
|
TOTALVIEW_VERSION
Contains the version number and the type of computer architecture upon which TotalView is executing. This is a read-only variable and cannot be set.
|
Permitted Values:
|
|
Default:
|
Prints errors, warnings, and informational messages. Informational messages include data on dynamic libraries and symbols.
Does not print error, warning, and informational messages. This also shuts off printing results from CLI commands. This should be used only when the CLI is run in batch mode.
|
Permitted Values:
|
|
Default:
|
WGROUP(pid)
The group ID of the thread group of worker threads associated with the process pid. This variable is read-only.
|
Permitted Values:
|
|
Default:
|
WGROUP(pid.tid)
|
|
|
Storing a nonzero value in this variable marks a thread as a worker. In this case, the returned value is the ID of the workers group associated with the control group, regardless of the actual nonzero value assigned to it.
|
Permitted Values:
|
A number representing the pid.tid
|
|
Default:
|