CLI Command Summary

actionpoint

Gets and sets action point properties

TV::actionpoint action [ object-id ] [ other-args ]

alias

Creates or views pseudonyms for commands

alias alias-name defn-body

Views previously defined aliases

alias [ alias-name ]

capture

Returns a command's output as a string

capture command

dactions

Displays information, saves, and reloads action points

dactions [ ap-id-list ]   [ -at source-loc ]
        [ -enabled | -disabled ]

Saves action points to a file

dactions -save [ filename ]

Loads previously saved action points

dactions -load [ filename ]

dassign

Changes the value of a scalar variable

dassign target value

dattach

Brings currently executing processes under CLI control

dattach [ -g gid ] [ -r hname ]
    [ -ask_attach_parallel | -no_attach_parallel ]
    [ -e ] fname pid-list

dbarrier

Creates a barrier breakpoint at a source location

dbarrier source-loc     [ -stop_when hit { group | process | none } ]
    [ -stop_when_done { group | process | none } ]

Creates a barrier breakpoint at an address

dbarrier -address addr
    [ -stop_when_hit { group | process | none } ]
    [ -stop_when_done { group | process | none } ]

dbreak

Creates a breakpoint at a source location

dbreak source-loc [ -p | -g | -t ]  [ [ -l lang ] -e expr ]

Creates a breakpoint at an address

dbreak -address addr [ -p | -g | -t]  [ [ -l lang ] -e expr ]

dcheckpoint

Creates a checkpoint image of processes (SGI only)

dcheckpoint [ after_checkpointing ] [ -by process_set ] [ -no_park ]
    [ -ask_attach_parallel | -no_attach_parallel ]
    [ -no_preserve_ids ] [ -force ] checkpoint-name

dcont

Continues execution and waits for execution to stop

dcont

ddelete

Deletes some action points

ddelete action-point-list

Deletes all action points

ddelete -a

ddetach

Detaches from the processes

ddetach

ddisable

Disables some action points

ddisable action-point-list

Disables all action points

ddisable -a

ddown

Moves down the call stack

ddown [ num-levels ]

dec2hex

Converts a decimal number into hexadecimal

TV::dec2hex number

denable

Enables some action points

denable action-point-list

Enables all disabled action points in the current focus

denable -a

dfocus

Changes the target of future CLI commands to this P/T set

dfocus p/t-set

Executes a command within this P/T set

dfocus p/t-set command

dgo

Resumes execution of target processes

dgo

dgroups

Adds members to thread and process groups

dgroups -add [ -g gid ] [ id-list ]

Deletes groups

dgroups -delete [ -g gid ]

Intersects a group with a list of processes and threads

dgroups -intersect [ -g gid ] [ id-list ]

Prints process and thread group information

dgroups [ -list ] [ pattern]

Creates a new thread or process group

dgroups -new [ thread_or_process ] [ -g gid ] [ id-list ]

Removes members for thread or process groups

dgroups -remove [ -g gid ] [ id-list ]

dhalt

Suspends execution of processes

dhalt

dhold

Holds processes

dhold -process

Holds threads

dhold -thread

dkill

Terminates execution of target processes

dkill

dlappend

Appends list elements to a TotalView variable

dlappend variable-name value [ ... ]

dlist

Displays code relative to the current list location

dlist [ -n num-lines ]

Displays code relative to a named location

dlist source-loc [ -n num-lines ]

Displays code relative to the current execution location

dlist -e [ -n num-lines ]

dload

Loads debugging information

dload [ -g gid ] [ -r hname] [ -e ] executable

dnext

Steps source lines, stepping over subroutines

dnext [ num-steps ]

dnexti

Steps machine instructions, stepping over subroutines

dnexti [ num-steps ]

dout

Runs out from current subroutine

dout [ frame-count ]

Runs until the PC returns into a procedure

dout proc-name

dprint

Prints the value of a variable

dprint variable

Prints the value of an expression

dprint expression

dptsets

Shows status of processes and threads in an array of P/T expressions

dptsets [ ptset_array ] ...

drerun

Restarts processes

drerun [ args ]

drestart

Restarts a checkpoint

drestart [ process-state ] [ -no_unpark ] [ -g gid ] [ -r host ]
    [ -ask_attach_parallel | -no_attach_parallel ]
    [ -no_preserve_ids ] checkpoint-name

drun

Starts or restarts processes

drun [ cmd_arguments ] [ < infile ]
    [ > [ > ][ & ] outfile ]
    [ 2> [ > ] errfile ]

dset

Creates or changes a CLI state variable

dset [ -new ] debugger-var value

Views current CLI state variables

dset [ debugger-var ]

source_process_startup

"Sources" a .tvd file when a process is loaded

TV::source_proccess_startup process_id

dstatus

Shows current status of processes and threads

dstatus

dstep

Steps lines, stepping into subfunctions

dstep [ num-steps ]

dstepi

Steps machine instructions, stepping into subfunctions

dstepi [ num-steps ]

dunhold

Releases a process

dunhold -process

Releases a thread

dunhold -thread

dunset

Restores a CLI variable to its default value

dunset debugger-var

Restores all CLI variables to their default values

dunset -all

duntil

Runs to a line

duntil line-number

Runs to an address

duntil -address addr

Runs into a function

duntil proc-name

dup

Moves up the call stack

dup [ num-levels ]

dwait

Blocks command input until the target processes stop

dwait

dwatch

Defines a watchpoint for a variable

dwatch variable [ -length byte-count ]   [ -p | -g | -t ]   
        [ [ -l lang ] -e expr ] [ -t type ]

Defines a watchpoint for an address

dwatch -address addr -length byte-count   [ -p | -g | -t ]
        [ [ -l lang ] -e expr ] [ -t type ]

dwhat

Determines what a name refers to

dwhat symbol-name

dwhere

Displays locations in the call stack

dwhere [ num-levels ] [ -args ]

Displays all locations in the call stack

dwhere -a [ -args ]

dworker

Adds or removes a thread from a workers group

dworker { number | boolean }

errorCodes

Returns a list of all error code tags

TV::errorCodes

Returns or raises error information

TV::errorCodes number_or_tag [ -raise [ message ] ]

exit

Terminates the debugging session

exit [ -force ]

focus_groups

Returns a list of groups in the current focus

TV::focus_groups

focus_processes

Returns a list of processes in the current focus

TV::focus_processes [ -all | -group | -process | -thread ]

focus_threads

Returns a list of threads in the current focus

TV::focus_threads [ -all | -group | -process | -thread ]

group

Gets and sets group properties

TV::group action [ object-id ] [ other-args ]

help

Displays help information

help [ topic ]

hex2dec

Converts to decimal

TV::hex2dec number

image

Gets and sets image properties

TV::image action [ object-id ] [ other-args ]

process

Gets and sets process properties

TV::process action [ object-id ] [ other-args ]

prototype

Gets and sets prototype properties

TV::prototype action [ object-id ] [ other-args ]

quit

Terminates the debugging session

quit [ -force ]

respond

Provides responses to commands

TV::respond response command

stty

Sets terminal properties

stty [ stty-args ]

thread

Gets and sets thread properties

TV::thread action [ object-id ] [ other-args ]

type

Gets and sets type properties

TV::type action [ object-id ] [ other-args ]

unalias

Removes an alias

unalias alias-name

Removes all aliases

unalias -all