CLI Commands

This section lists all of the CLI commands. It also contains a short explanation of what each command does.

Environment Commands

The CLI commands in this group provide information on the general CLI operating environment:

• alias: Creates or views pseudonym for commands and arguments.
• capture: Allows commands that print information to instead send their output to a variable.
• dlappend: Appends list elements to a TotalView variable.
• dset: Changes or views values of TotalView state variables.
• dunset: Restores default settings of TotalView state variables.
• help: Displays help information.
• stty: Sets terminal properties.
• unalias: Removes a previously defined alias.

CLI Initialization and Termination

These commands initialize and terminate the CLI session, and add processes to CLI control:

• dattach: Brings one or more processes currently executing in the normal run-time environment (that is, outside TotalView) under TotalView control.
• ddetach: Detaches TotalView from a process.
• dkill: Kills existing user processes, leaving debugging information in place.
• dload: Loads debugging information about the program into TotalView and prepares it for execution.
• drerun: Restarts a process.
• drun: Starts or restarts the execution of user processes under control of the CLI.
• exit, quit: Exits from TotalView, ending the debugging session.

Program Information

The following commands provide information about a program's current execution location and allow you to browse the program's source files:

• ddown: Navigates through the call stack by manipulating the current frame.
• dlist: Browses source code relative to a particular file, procedure, or line.
• dprint: Evaluates an expression or program variable and displays the resulting value.
• dptsets: Shows status of processes and threads in a P/T set.
• dstatus: Shows status of processes and threads.
• dup: Navigates through the call stack by manipulating the current frame.
• dwhat: Determines what a name refers to.
• dwhere: Prints information about the thread's stack.

Execution Control

The following commands control execution:

• dcont: Continues execution of processes and waits for them.
• dfocus: Changes the set of processes, threads, or groups upon which a CLI command acts.
• dgo: Resumes execution of processes (without blocking).
• dgroups: Manipulates and manages groups.
• dhalt: Suspends execution of processes.
• dhold: Holds threads or processes.
• dnext: Executes statements, stepping over subfunctions.
• dnexti: Executes machine instructions, stepping over subfunctions.
• dout: Runs out of current procedure.
• dstep: Executes statements, moving into subfunctions if required.
• dstepi: Executes machine instructions, moving into subfunctions if required.
• dunhold: Releases held threads.
• duntil: Executes statements until a statement is reached.
• dwait: Blocks command input until processes stop.
• dworker: Adds or removes threads from a workers group.

Action Points

The following action point commands are responsible for defining and manipulating the points at which the flow of program execution should stop so that you can examine debugger or program state:

• dactions: Views information on action point definitions and their current status; it also saves and restores action points.
• dbarrier: Defines a process barrier breakpoint.
• dbreak: Defines a breakpoint.
• ddelete: Deletes an action point.
• ddisable: temporarily disables an action point.
• denable: Reenables an action point that has been disabled.
• dwatch: Defines a watchpoint.

Other Commands

The commands in the category do not fit into any of the other categories.

• dassign: Changes the value of a scalar variable.
• dcheckpoint: Creates a file that can later be used to restart a program.
• drestart: Restarts a checkpoint.

Accessor Functions

The following functions, all within the TV:: namespace, access and set TotalView properties:

• actionpoint: Accesses and sets action point properties.
• focus_groups: Returns a list containing the groups in the current focus.
• focus_processes: Returns a list of processes in the current focus.
• focus_threads: Returns a list of threads in the current focus.
• group: Accesses and sets group properties.
• image: Accesses and sets image properties.
• process: Accesses and sets process properties.
• prototype: Accesses and sets prototype properties.
• thread: Accesses and sets thread properties.
• type: Accesses and sets data type properties.

Helper Functions

The following commands, all within the TV:: namespace, are most often used within scripts:

• dec2hex: Converts a decimal number into hexadecimal format.
• dlappend: Appends list elements to a TotalView variable.
• errorCodes: Returns or raises TotalView error information.
• hex2dec: Converts a hexadecimal number into decimal format.
• respond: Sends a response to a command.
• source_process_startup: "Sources" a .tvd file when a process is loaded