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 ]

[ -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