TotalView Users Guide - CI Wiki

Using the CLI Interface
Starting the CLI
You interact with the CLI by entering a CLI or Tcl command. (Entering a Tcl
command does exactly the same thing in the CLI as it does when interacting
with a Tcl interpreter.) Typically, the effect of executing a CLI command
is one or more of the following:
� The CLI displays information about your program.
� A change takes place in your program’s state.
� A change takes place in the information that the CLI maintains about
your program.
After the CLI executes your command, it displays a prompt. Although CLI
commands are executed sequentially, commands executed by your program
might not be. For example, the CLI doesn’t require that your program
be stopped when it prompts for and performs commands. It only requires
that the last CLI command be complete before it can begin executing the
next one. In many cases, the processes and threads being debugged continue
to execute after the CLI finished doing what you asked it to do.
If you need to stop an executing command or Tcl macro, press Ctrl+C
while the command is executing. If the CLI is displaying its prompt, typing
Ctrl+C stops executing processes.
Because actions are occurring constantly, state information and other
kinds of messages that the CLI displays are usually mixed in with the commands
that you type. You might want to limit the amount of information
TotalView displays by setting the VERBOSE variable to WARNING or ERROR.
(For more information, see the “Variables” chapter in the TotalView Reference
Guide.)
Starting the CLI
You can start the CLI in one of the following ways:
� You can start the CLI from the GUI by selecting the Tools > Command
Line command in the Root or Process Windows. After selecting this command,
TotalView opens a window into which you can enter CLI commands.
� You can start the CLI directly from a shell prompt by typing totalviewcli.
(This assumes that the TotalView binary directory is in your path.)
Figure 139 on page 202 is a snapshot of a CLI window that shows part of a
program being debugged.
If you have problems entering and editing commands, it might be because you
invoked the CLI from a shell or process that manipulates your stty settings.
TotalView Users Guide: version 8.7 201