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 ]

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 ]

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