Totalview® for HPC Reference Guide : PART I CLI Commands : Chapter 1 CLI Command Summary
Chapter 1 CLI Command Summary
This chapter contains a summary of all TotalView debugger CLI commands. The commands are described in detail in Chapter 2, "CLI Commands" and Chapter 3, "CLI Namespace Commands".
actionpoint
Gets and sets action point properties
TV::actionpoint action [ object-id ] [ other-args ]
alias
Creates a new user-defined pseudonym for a command
alias alias-name defn-body
Views previously defined aliases
alias [ alias-name ]
capture
Returns a command’s output as a string
capture [ -out | -err | -both ] [ -f filename ] command
dactions
Displays information about action points
dactions [ ap-id-list ] [ -at source-loc ]
[ -enabled | -disabled ]
[ -enabled_blocks | -disabled_blocks ]
[ -block_images ]
[ -block_lines ]
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 TotalView control
dattach [-g gid] [-r hname ]
[ -ask_attach_parallel | -no_attach_parallel ]
[ -replay | -no_replay ]
[ -go | -halt ] [ -rank num]
[ -c { core-file | recording-file } ]
[ -e ] executable [ pid-list ]
[ -parallel_attach_subset subset_specification ]
dbarrier
Creates a barrier breakpoint at a source location
dbarrier breakpoint-expr [ -stop_when_hit { group | process | none } ]
[ -stop_when_done { group | process | none } ] [ -pending ]
Creates a barrier breakpoint at an address
dbarrier -address addr [ -stop_when_hit { group | process | none } ]
[ -stop_when_done { group | process | none } ] [ -pending ]
dbreak
Creates a breakpoint at a source location
dbreak breakpoint-expr [ -p | -g | -t ]  [ [ -l lang ] -e expr ] [ -pending ]
Creates a breakpoint at an address
dbreak -address addr [ -p | -g | -t]  [ [ -l lang ] -e expr ] [ -pending ]
dcache
Clears the remote library cache
dcache -flush
dcalltree
Displays parallel backtrace data
[-data pbv_data_array] [-show_details] [-sort columns] [-hide_backtrace]
[-save_as_csv filename] [-save_as_dot filename]
dcheckpoint
Creates a checkpoint on IBM AIX
dcheckpoint [ -delete | -halt ]
dcont
Continues execution and waits for execution to stop
dcont
dcuda
Manages NVIDIA® CUDA™ GPU threads, providing the ability to inspect them, change the focus, and display their status.
dcuda
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 [ -block number-list ]
Disables all action points
ddisable -a
ddlopen
Loads a shared object library
ddlopen [ -now | -lazy ] [ -local | -global ] [ -mode int ] filespec
Displays information about shared object libraries
ddlopen [ -list dll-ids... ]
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
dexamine
Display memory contents
dexamine [ -column_count cnt ] [ -count cnt ] [ -data_only ]
[ -show_chars ] [ -string_length len ] [ -format fmt ]
[ -memory_info ] [ -wordsize size ] variable_or_expression
dflush
Removes the top-most suspended expression evaluation
dflush
Removes all suspended dprint computations
dflush -all
Removes dprint computations preceding and including a suspended evaluation ID
dflush susp-eval-id
dfocus
Changes the target of future CLI commands to this P/T set
dfocus p/t-set
Executes a command in this P/T set
dfocus [ p/t-set command ]
dga
Displays global array variables
dga [-lang lang_type] [ handle_or_name ] [ slice ]
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-list ]
Creates a new thread or process group
dgroups -new [ thread_or_process ] [ -g gid ] [ id-list ]
Removes members from thread or process groups
dgroups -remove [ -g gid ] [ id-list ]
dhalt
Suspends execution of processes
dhalt
dheap
Shows Memory Debugger state
dheap [ -status ]
Applies a saved configuration file
dheap -apply_config { default | filename }
Shows information about a backtrace
dheap -backtrace [ subcommands ]
Compares memory states
dheap -compare subcommands [ optional_subcommands ]
[ process | filename [ process | filename ] ]
Enables or disables the Memory Debugger
dheap { -enable | -disable }
Enables or disables event notification
dheap -event_filter subcommands
Writes memory information
dheap -export subcommands
Specifies which filters the Memory Debugger uses
dheap -filter subcommands
Writes guard blocks (memory before and after an allocation)
dheap -guard [ subcommands ]
Enables and disables the retaining (hoarding) of freed memory blocks
dheap -hoard [ subcommands ]
Displays Memory Debugger information
dheap -info [ -backtrace ] [ start_address [ end_address ] ]
Indicates whether an address is within a deallocated block
dheap -is_dangling address
Locates memory leaks
dheap -leaks [ -check_interior ]
Enables or disables Memory Debugger event notification
dheap -[no]notify
Paints memory with a distinct pattern
dheap -paint [ subcommands ]
Enables and disables the ability to catch bounds errors and use-after-free errors retaining freed memory blocks
dheap -red_zones [ subcommands ]
Enables and disables allocation and reallocation notification
dheap -tag_alloc subcommand start_address [ end_address]
Displays the Memory Debugger’s version number
dheap -version
dhistory
Displays information about the state of the program as it is being replayed. If you have received a timestamp, you can go back to the line that was executing at that time.
dhistory [ -info ] [ -get_time ] [ -go_time time ] [ -go_live ]
[ -enable ] [ -disable ]
dhold
Holds processes
dhold -process
Holds threads
dhold -thread
dkill
Terminates execution of target processes
dkill [ -remove ]
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 breakpoint-expr [ -n num-lines ]
Displays code relative to the current execution location
dlist -e [ -n num-lines ]
dll
Manages shared libraries
TV::dll action [ dll-id-list ] [ -all ]
dload
Loads debugging information
dload [ -g gid ] [ -mpi starter_value ] [ -r hname]
[ -replay | -noreplay ]
[ -env variable=value] ... [ -e ] executable
[ -parallel_attach_subset subset_specification ]
dmstat
Displays memory use information
dmstat
dnext
Steps source lines, stepping over subroutines
dnext [ -back ] [ num-steps ]
dnexti
Steps machine instructions, stepping over subroutines
dnexti [ -back ] [ num-steps ]
dout
Executes until just after the place that called the current routine
dout [ -back ] [ frame-count ]
dprint
Prints the value of a variable or expression
dprint [ -nowait ] [ -slice slice_expr ] [ -stats [ -data ] ] variable_or_expression
dptsets
Shows the status of processes and threads in an array of P/T expressions
dptsets [ ptset_array ] ...
drerun
Restarts processes
drerun [ cmd_arguments ] [ < infile ]
[ > [ > ][ & ] outfile ]
[ 2> [ > ] errfile ]
drestart
Restarts a checkpoint on AIX
drestart [ -halt ] [ -g gid ] [ -r host ] [ -no_same_hosts ]
Restarts a checkpoint on SGI
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 ]
dsession
Loads a session
dsession [ -load session_name ]
 
dset
Creates or changes a CLI state variable
dset debugger-var value
Views current CLI state variables
dset [ debugger-var ]
Sets the default for a CLI state variable
dset -set_as_default debugger-var value
dstatus
Shows current status of processes and threads
dstatus
dstep
Steps lines, stepping into subfunctions
dstep [ -back ] [ num-steps ]
dstepi
Steps machine instructions, stepping into subfunctions
dstepi [ -back ] [ 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 [ -back ] line-number
Runs to an address
duntil [ -back ] -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 [ -level level-num ] [ num-levels ] [ -args ] [ -locals ] [ -registers ]
[ -noshow_pc ][ -noshow_fp ][ -show_image ]
Displays all locations in the call stack
dwhere -all [ -args ] [ -locals ] [-registers ]
[ -noshow_pc ][ -noshow_fp ][ -show_image ]
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 ]
expr
Manipulates values created by dprint -nowait
TV::expr action [ susp-eval-id ] [ other-args ]
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
process
Gets and sets process properties
TV::process action [ object-id ] [ other-args ]
quit
Terminates the debugging session
quit [ -force ]
read_symbols
Reads symbols from libraries
TV::read_symbols -lib lib-name-list
Reads symbols from libraries associated with a stack frame
TV::read_symbols -frame [ number ]
Reads symbols for all frames in the backtrace
TV::read_symbols -stack
respond
Provides responses to commands
TV::respond response command
scope
Gets and sets internal scope properties
TV::scope action [ object-id ] [ other-args ]
source_process_startup
“Sources” a .tvd file when a process is loaded
TV::source_proccess_startup process_id
spurs
Manages threads using commands modeled after the GDB SPU Runtime System (SPU) library.
spurs add [ directory directory-list ... ]
stty
Sets terminal properties
stty [ stty-args ]
symbol
Returns or sets internal TotalView symbol information
TV::symbol action [ object-id ] [ other-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 ]
type_transformation
Creates type transformations and examines properties
TV::type_transformation action [ object-id ] [ other-args ]
unalias
Removes an alias
unalias alias-name
Removes all aliases
unalias -all