Chapter 1 CLI Command Summary
This chapter contains a summary of all TotalView® Debugger CLI commands. The commands are described in detail in
Chapter 4, "CLI Commands" and
Chapter 5, "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 ]
[ -replay | -no_replay ]
[ -go | -halt ]
[ -ask_attach_parallel | -no_attach_parallel ]
[ -c corefile-name ] [ -rank num ]
[ -e ] fname 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