ARM® DS-5 Debugger Command Reference

Version 5.21


Table of Contents

Preface
About this book
Using this book
Glossary
Typographic conventions
Feedback
Other information
1 DS-5 Debugger commands
1.1 Conformance and usage rules for DS-5 Debugger commands
1.1.1 Syntax
1.1.2 Special characters and environment variables in paths
1.1.3 Expressions within DS-5
1.1.4 Built-in functions within DS-5 expressions
1.1.5 Usage of wildcards
1.1.6 Regular expressions in the C expression parser
1.1.7 The C++ scoping resolution operator
1.1.8 printf() style format string
1.2 DS-5 Debugger commands listed in groups
1.2.1 Breakpoints and watchpoints
1.2.2 Execution control
1.2.3 Tracing
1.2.4 Scripts
1.2.5 Call stack
1.2.6 Operating System (OS)
1.2.7 Files
1.2.8 Data
1.2.9 Memory
1.2.10 Cache
1.2.11 Registers
1.2.12 MMU
1.2.13 MMU list
1.2.14 Display
1.2.15 Information
1.2.16 Log
1.2.17 Set
1.2.18 Set elf
1.2.19 Show
1.2.20 Show elf
1.2.21 Flash
1.2.22 Support
1.3 DS-5 Debugger commands listed in alphabetical order
1.3.1 add-symbol-file
1.3.2 advance
1.3.3 append
1.3.4 assemble
1.3.5 awatch
1.3.6 backtrace, info stack, where
1.3.7 break
1.3.8 break-script
1.3.9 break-stop-on-cores, break-stop-on-threads
1.3.10 break-stop-on-vmid
1.3.11 cache flush
1.3.12 cache list
1.3.13 cache print
1.3.14 cd
1.3.15 clear
1.3.16 clearwatch
1.3.17 condition
1.3.18 continue
1.3.19 core, thread
1.3.20 core apply, thread apply
1.3.21 define
1.3.22 delete breakpoints
1.3.23 delete memory
1.3.24 directory, set directories
1.3.25 disable breakpoints
1.3.26 disable memory
1.3.27 disassemble
1.3.28 discard-symbol-file
1.3.29 document
1.3.30 down
1.3.31 down-silently
1.3.32 dump
1.3.33 echo
1.3.34 enable breakpoints
1.3.35 enable memory
1.3.36 end
1.3.37 exit, quit
1.3.38 file, symbol-file
1.3.39 finish
1.3.40 flash load
1.3.41 frame
1.3.42 handle
1.3.43 hbreak
1.3.44 help
1.3.45 if
1.3.46 ignore
1.3.47 info address
1.3.48 info all-registers
1.3.49 info breakpoints, info watchpoints
1.3.50 info breakpoints capabilities, info watchpoints capabilities
1.3.51 info capabilities
1.3.52 info classes
1.3.53 info cores
1.3.54 info files, info target
1.3.55 info flash
1.3.56 info frame
1.3.57 info functions
1.3.58 info handle, info signals
1.3.59 info inst-sets
1.3.60 info locals
1.3.61 info members
1.3.62 info memory
1.3.63 info memory-parameters
1.3.64 info os-log
1.3.65 info os-modules
1.3.66 info os-version
1.3.67 info processes
1.3.68 info registers
1.3.69 info semihosting
1.3.70 info sharedlibrary
1.3.71 info signals, info handle
1.3.72 info sources
1.3.73 info stack, backtrace, where
1.3.74 info symbol
1.3.75 info target, info files
1.3.76 info threads
1.3.77 info variables
1.3.78 info watchpoints, info breakpoints
1.3.79 info watchpoints capabilities, info breakpoints capabilities
1.3.80 inspect, print
1.3.81 interrupt, stop
1.3.82 list
1.3.83 load
1.3.84 loadfile
1.3.85 log config
1.3.86 log file
1.3.87 memory
1.3.88 memory auto
1.3.89 memory debug-cache
1.3.90 memory fill
1.3.91 memory set
1.3.92 memory set_typed
1.3.93 mmu list memory-maps
1.3.94 mmu list tables
1.3.95 mmu list translations
1.3.96 mmu memory-map
1.3.97 mmu print
1.3.98 mmu translate
1.3.99 newvar
1.3.100 next
1.3.101 nexti
1.3.102 nexts
1.3.103 nosharedlibrary
1.3.104 output
1.3.105 pause
1.3.106 preprocess
1.3.107 print, inspect
1.3.108 pwd
1.3.109 quit, exit
1.3.110 reload-symbol-file
1.3.111 reset
1.3.112 resolve
1.3.113 restore
1.3.114 reverse-continue
1.3.115 reverse-next
1.3.116 reverse-nexti
1.3.117 reverse-step
1.3.118 reverse-stepi
1.3.119 reverse-step-out
1.3.120 run
1.3.121 rwatch
1.3.122 select-frame
1.3.123 set, set variable
1.3.124 set arm
1.3.125 set auto-solib-add
1.3.126 set backtrace
1.3.127 set blocking-run-control
1.3.128 set breakpoint
1.3.129 set case-insensitive-source-matching
1.3.130 set debug-agent
1.3.131 set debug-from
1.3.132 set directories, directory
1.3.133 set dtsl-options
1.3.134 set dtsl-temporary-directory
1.3.135 set elf load-segments-at-p_paddr
1.3.136 set elf zero-extra-segment-bytes
1.3.137 set endian
1.3.138 set escape-strings
1.3.139 set escapes-in-filenames
1.3.140 set listsize
1.3.141 set mmu use-cache-for-phys-reads
1.3.142 set os
1.3.143 set print
1.3.144 set semihosting
1.3.145 set solib-absolute-prefix, set sysroot
1.3.146 set solib-search-path
1.3.147 set step-mode
1.3.148 set stop-on-solib-events
1.3.149 set substitute-path
1.3.150 set sysroot, set solib-absolute-prefix
1.3.151 set trust-ro-sections-for-opcodes
1.3.152 set variable, set
1.3.153 set wildcard-style
1.3.154 sharedlibrary
1.3.155 shell
1.3.156 show
1.3.157 show architecture
1.3.158 show arm
1.3.159 show auto-solib-add
1.3.160 show backtrace
1.3.161 show blocking-run-control
1.3.162 show breakpoint
1.3.163 show case-insensitive-source-matching
1.3.164 show debug-agent
1.3.165 show debug-from
1.3.166 show directories
1.3.167 show dtsl-options
1.3.168 show dtsl-temporary-directory
1.3.169 show elf load-segments-at-p_paddr
1.3.170 show elf zero-extra-segment-bytes
1.3.171 show endian
1.3.172 show escape-strings
1.3.173 show escapes-in-filenames
1.3.174 show listsize
1.3.175 show mmu use-cache-for-phys-reads
1.3.176 show os
1.3.177 show print
1.3.178 show semihosting
1.3.179 show solib-absolute-prefix, show sysroot
1.3.180 show solib-search-path
1.3.181 show step-mode
1.3.182 show stop-on-solib-events
1.3.183 show substitute-path
1.3.184 show sysroot, show solib-absolute-prefix
1.3.185 show trust-ro-sections-for-opcodes
1.3.186 show version
1.3.187 show wildcard-style
1.3.188 silence
1.3.189 source
1.3.190 start
1.3.191 stdin
1.3.192 step
1.3.193 stepi
1.3.194 steps
1.3.195 stop, interrupt
1.3.196 symbol-file, file
1.3.197 tbreak
1.3.198 thbreak
1.3.199 thread, core
1.3.200 thread apply, core apply
1.3.201 trace clear
1.3.202 trace dump
1.3.203 trace info
1.3.204 trace list
1.3.205 trace report
1.3.206 trace start
1.3.207 trace stop
1.3.208 unset
1.3.209 unsilence
1.3.210 up
1.3.211 up-silently
1.3.212 wait
1.3.213 watch
1.3.214 whatis
1.3.215 where, backtrace, info stack
1.3.216 while
1.3.217 x
2 CMM-style commands supported by the debugger
2.1 Conformance and usage of CMM-style commands
2.2 CMM-style commands groups: All
2.2.1 Controlling breakpoints
2.2.2 Controlling data and display settings
2.2.3 Controlling images, symbols, and libraries
2.2.4 Controlling target execution and connections
2.2.5 Displaying the call stack and associated variables
2.2.6 yes
2.2.7 Supporting commands
2.3 CMM-style commands listed in alphabetical order
2.3.1 break
2.3.2 break.delete
2.3.3 break.disable
2.3.4 break.enable
2.3.5 break.set
2.3.6 data.dump
2.3.7 data.load.binary
2.3.8 data.load.elf
2.3.9 data.set
2.3.10 go
2.3.11 help
2.3.12 print
2.3.13 register.set
2.3.14 system.down
2.3.15 system.up
2.3.16 var.frame
2.3.17 var.global
2.3.18 var.local
2.3.19 var.new
2.3.20 var.print
2.3.21 var.set
2.3.22 wait
A GNU Free Documentation License
A.1 GNU Free Documentation License
A.2 ADDENDUM: How to use this License for your documents

Release Information

Document History
Issue Date Confidentiality Change
A 30 June 2010 Non-Confidential First release
B 30 September 2010 Non-Confidential Update for DS-5 version 5.2
C 30 November 2010 Non-Confidential Update for DS-5 version 5.3
D 30 January 2011 Non-Confidential Update for DS-5 version 5.4
E 30 May 2011 Non-Confidential Update for DS-5 version 5.5
F 30 July 2011 Non-Confidential Update for DS-5 version 5.6
G 30 September 2011 Non-Confidential Update for DS-5 version 5.7
H 30 November 2012 Non-Confidential Update for DS-5 version 5.8
I 28 February 2012 Non-Confidential Update for DS-5 version 5.9
J 30 May 2012 Non-Confidential Update for DS-5 version 5.10
K 30 July 2012 Non-Confidential Update for DS-5 version 5.11
L 30 October 2012 Non-Confidential Update for DS-5 version 5.12
M 15 December 2012 Non-Confidential Update for DS-5 version 5.13
N 15 March 2013 Non-Confidential Update for DS-5 version 5.14
O 14 June 2013 Non-Confidential Update for DS-5 version 5.15
Q 16 October 2013 Non-Confidential Update for DS-5 version 5.17
R 14 March 2014 Non-Confidential Update for DS-5 version 5.18
S 27 June 2014 Non-Confidential Update for DS-5 version 5.19
T 17 September 2014 Non-Confidential Update for DS-5 version 5.20
U 20 March 2015 Non-Confidential Update for DS-5 version 5.21

Non-Confidential Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarks of ARM in the EU and other countries, except as otherwise stated below in this proprietary notice. Other brands and names mentioned herein may be the trademarks of their respective owners.
Except as provided herein, neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except with the prior written permission of the copyright holder.
The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given by ARM in good faith. However, all warranties implied or expressed, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.
This document is intended only to assist the reader in the use of the product. ARM shall not be liable for any loss or damage arising from the use of any information in this document, or any error or omission in such information, or any incorrect use of the product.
Where the term ARM is used it means “ARM or any of its subsidiaries as appropriate”.
Copyright © 2009 ARM. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

Confidentiality Status

This document is Non-Confidential. The right to use, copy and disclose this document may be subject to license restrictions in accordance with the terms of the agreement entered into by ARM and the party that ARM delivered this document to.
Unrestricted Access is an ARM internal classification.

Product Status

The information in this document is Final, that is for a developed product.

Web Address

Non-ConfidentialPDF file icon PDF versionARM DUI0452U
Copyright © 2010-2015 ARM. All rights reserved.