ARM® DS-5 Debugger Command Reference

Version 5.26


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 Usage of the 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-set-property
1.3.10 break-stop-on-cores, break-stop-on-threads
1.3.11 break-stop-on-vmid
1.3.12 cache flush
1.3.13 cache list
1.3.14 cache print
1.3.15 cd
1.3.16 clear
1.3.17 clearwatch
1.3.18 condition
1.3.19 continue
1.3.20 core, thread
1.3.21 core apply, thread apply
1.3.22 define
1.3.23 delete breakpoints
1.3.24 delete memory
1.3.25 directory, set directories
1.3.26 disable breakpoints
1.3.27 disable memory
1.3.28 disassemble
1.3.29 discard-symbol-file
1.3.30 document
1.3.31 down
1.3.32 down-silently
1.3.33 dump
1.3.34 echo
1.3.35 enable breakpoints
1.3.36 enable memory
1.3.37 end
1.3.38 exit, quit
1.3.39 file, symbol-file
1.3.40 finish
1.3.41 flash load
1.3.42 frame
1.3.43 handle
1.3.44 hbreak
1.3.45 help
1.3.46 if
1.3.47 ignore
1.3.48 info address
1.3.49 info all-registers
1.3.50 info breakpoints, info watchpoints
1.3.51 info breakpoints capabilities, info watchpoints capabilities
1.3.52 info capabilities
1.3.53 info classes
1.3.54 info cores
1.3.55 info files, info target
1.3.56 info flash
1.3.57 info frame
1.3.58 info functions
1.3.59 info handle, info signals
1.3.60 info inst-sets
1.3.61 info locals
1.3.62 info members
1.3.63 info memory
1.3.64 info memory-parameters
1.3.65 info os
1.3.66 info os-log
1.3.67 info os-modules
1.3.68 info os-version
1.3.69 info overlays
1.3.70 info processes
1.3.71 info registers
1.3.72 info semihosting
1.3.73 info sharedlibrary
1.3.74 info signals, info handle
1.3.75 info sources
1.3.76 info stack, backtrace, where
1.3.77 info symbol
1.3.78 info target, info files
1.3.79 info threads
1.3.80 info variables
1.3.81 info watchpoints, info breakpoints
1.3.82 info watchpoints capabilities, info breakpoints capabilities
1.3.83 inspect, print
1.3.84 interrupt, stop
1.3.85 list
1.3.86 load
1.3.87 loadfile
1.3.88 log config
1.3.89 log file
1.3.90 memory
1.3.91 memory auto
1.3.92 memory debug-cache
1.3.93 memory fill
1.3.94 memory set
1.3.95 memory set_typed
1.3.96 mmu list memory-maps
1.3.97 mmu list tables
1.3.98 mmu list translations
1.3.99 mmu memory-map
1.3.100 mmu print
1.3.101 mmu translate
1.3.102 newvar
1.3.103 next
1.3.104 nexti
1.3.105 nexts
1.3.106 nosharedlibrary
1.3.107 output
1.3.108 pause
1.3.109 preprocess
1.3.110 print, inspect
1.3.111 pwd
1.3.112 quit, exit
1.3.113 reload-symbol-file
1.3.114 reset
1.3.115 resolve
1.3.116 restore
1.3.117 reverse-continue
1.3.118 reverse-next
1.3.119 reverse-nexti
1.3.120 reverse-step
1.3.121 reverse-stepi
1.3.122 reverse-step-out
1.3.123 run
1.3.124 rwatch
1.3.125 select-frame
1.3.126 set, set variable
1.3.127 set arm
1.3.128 set auto-solib-add
1.3.129 set backtrace
1.3.130 set blocking-run-control
1.3.131 set breakpoint
1.3.132 set case-insensitive-source-matching
1.3.133 set debug-agent
1.3.134 set debug-from
1.3.135 set directories, directory
1.3.136 set dtsl-options
1.3.137 set dtsl-temporary-directory
1.3.138 set elf cache-uninitialized-sections
1.3.139 set elf load-segments-at-p_paddr
1.3.140 set elf zero-extra-segment-bytes
1.3.141 set endian
1.3.142 set escape-strings
1.3.143 set escapes-in-filenames
1.3.144 set listsize
1.3.145 set mmu use-cache-for-phys-reads
1.3.146 set os
1.3.147 set overlays enabled
1.3.148 set print
1.3.149 set semihosting
1.3.150 set solib-absolute-prefix, set sysroot
1.3.151 set solib-search-path
1.3.152 set step-mode
1.3.153 set stop-on-solib-events
1.3.154 set substitute-path
1.3.155 set sysroot, set solib-absolute-prefix
1.3.156 set trust-ro-sections-for-opcodes
1.3.157 set variable, set
1.3.158 set wildcard-style
1.3.159 sharedlibrary
1.3.160 shell
1.3.161 show
1.3.162 show architecture
1.3.163 show arm
1.3.164 show auto-solib-add
1.3.165 show backtrace
1.3.166 show blocking-run-control
1.3.167 show breakpoint
1.3.168 show case-insensitive-source-matching
1.3.169 show debug-agent
1.3.170 show debug-from
1.3.171 show directories
1.3.172 show dtsl-options
1.3.173 show dtsl-temporary-directory
1.3.174 show elf cache-uninitialized-sections
1.3.175 show elf load-segments-at-p_paddr
1.3.176 show elf zero-extra-segment-bytes
1.3.177 show endian
1.3.178 show escape-strings
1.3.179 show escapes-in-filenames
1.3.180 show listsize
1.3.181 show mmu use-cache-for-phys-reads
1.3.182 show os
1.3.183 show print
1.3.184 show semihosting
1.3.185 show solib-absolute-prefix, show sysroot
1.3.186 show solib-search-path
1.3.187 show step-mode
1.3.188 show stop-on-solib-events
1.3.189 show substitute-path
1.3.190 show sysroot, show solib-absolute-prefix
1.3.191 show trust-ro-sections-for-opcodes
1.3.192 show version
1.3.193 show wildcard-style
1.3.194 silence
1.3.195 source
1.3.196 start
1.3.197 stdin
1.3.198 step
1.3.199 stepi
1.3.200 steps
1.3.201 stop, interrupt
1.3.202 symbol-file, file
1.3.203 tbreak
1.3.204 thbreak
1.3.205 thread, core
1.3.206 thread apply, core apply
1.3.207 trace clear
1.3.208 trace dump
1.3.209 trace info
1.3.210 trace list
1.3.211 trace report
1.3.212 trace start
1.3.213 trace stop
1.3.214 unset
1.3.215 unsilence
1.3.216 up
1.3.217 up-silently
1.3.218 usecase help
1.3.219 usecase list
1.3.220 usecase run
1.3.221 wait
1.3.222 watch
1.3.223 watch-set-property
1.3.224 whatis
1.3.225 where, backtrace, info stack
1.3.226 while
1.3.227 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 Controlling the debugger and program information
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
P 16 September 2013 Non-Confidential Update for DS-5 version 5.16
Q 13 December 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
V 15 July 2015 Non-Confidential Update for DS-5 version 5.22
W 15 October 2015 Non-Confidential Update for DS-5 version 5.23
X 15 March 2016 Non-Confidential Update for DS-5 version 5.24
Y 15 July 2016 Non-Confidential Update for DS-5 version 5.25
Z 18 November 2016 Non-Confidential Update for DS-5 version 5.26

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 DUI0452Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.