ARM® DS-5 DS-5 Debugger Command Reference

Version 5.27


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 MPU
1.2.15 MPU list
1.2.16 Display
1.2.17 Information
1.2.18 Log
1.2.19 Set
1.2.20 Set elf
1.2.21 Show
1.2.22 Show elf
1.2.23 Flash
1.2.24 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, mpu list memory-maps
1.3.97 mmu list tables, mpu list tables
1.3.98 mmu list translations
1.3.99 mmu memory-map, mpu memory-map
1.3.100 mmu print, mpu print
1.3.101 mmu translate
1.3.102 mpu list memory-maps, mmu list memory-maps
1.3.103 mpu list tables, mmu list tables
1.3.104 mpu memory-map, mmu memory-map
1.3.105 mpu print, mmu print
1.3.106 newvar
1.3.107 next
1.3.108 nexti
1.3.109 nexts
1.3.110 nosharedlibrary
1.3.111 output
1.3.112 pause
1.3.113 preprocess
1.3.114 print, inspect
1.3.115 pwd
1.3.116 quit, exit
1.3.117 reload-symbol-file
1.3.118 reset
1.3.119 resolve
1.3.120 restore
1.3.121 reverse-continue
1.3.122 reverse-next
1.3.123 reverse-nexti
1.3.124 reverse-step
1.3.125 reverse-stepi
1.3.126 reverse-step-out
1.3.127 run
1.3.128 rwatch
1.3.129 select-frame
1.3.130 set, set variable
1.3.131 set arm
1.3.132 set auto-solib-add
1.3.133 set backtrace
1.3.134 set blocking-run-control
1.3.135 set breakpoint
1.3.136 set case-insensitive-source-matching
1.3.137 set debug-agent
1.3.138 set debug-from
1.3.139 set directories, directory
1.3.140 set dtsl-options
1.3.141 set dtsl-temporary-directory
1.3.142 set elf cache-uninitialized-sections
1.3.143 set elf load-segments-at-p_paddr
1.3.144 set elf zero-extra-segment-bytes
1.3.145 set endian
1.3.146 set escape-strings
1.3.147 set escapes-in-filenames
1.3.148 set idau-region
1.3.149 set listsize
1.3.150 set mmu use-cache-for-phys-reads
1.3.151 set os
1.3.152 set overlays enabled
1.3.153 set print
1.3.154 set semihosting
1.3.155 set solib-absolute-prefix, set sysroot
1.3.156 set solib-search-path
1.3.157 set step-mode
1.3.158 set stop-on-solib-events
1.3.159 set substitute-path
1.3.160 set sysroot, set solib-absolute-prefix
1.3.161 set trust-ro-sections-for-opcodes
1.3.162 set variable, set
1.3.163 set wildcard-style
1.3.164 sharedlibrary
1.3.165 shell
1.3.166 show
1.3.167 show architecture
1.3.168 show arm
1.3.169 show auto-solib-add
1.3.170 show backtrace
1.3.171 show blocking-run-control
1.3.172 show breakpoint
1.3.173 show case-insensitive-source-matching
1.3.174 show debug-agent
1.3.175 show debug-from
1.3.176 show directories
1.3.177 show dtsl-options
1.3.178 show dtsl-temporary-directory
1.3.179 show elf cache-uninitialized-sections
1.3.180 show elf load-segments-at-p_paddr
1.3.181 show elf zero-extra-segment-bytes
1.3.182 show endian
1.3.183 show escape-strings
1.3.184 show escapes-in-filenames
1.3.185 show idau-region
1.3.186 show listsize
1.3.187 show mmu use-cache-for-phys-reads
1.3.188 show os
1.3.189 show print
1.3.190 show semihosting
1.3.191 show solib-absolute-prefix, show sysroot
1.3.192 show solib-search-path
1.3.193 show step-mode
1.3.194 show stop-on-solib-events
1.3.195 show substitute-path
1.3.196 show sysroot, show solib-absolute-prefix
1.3.197 show trust-ro-sections-for-opcodes
1.3.198 show version
1.3.199 show wildcard-style
1.3.200 silence
1.3.201 source
1.3.202 start
1.3.203 stdin
1.3.204 step
1.3.205 stepi
1.3.206 steps
1.3.207 stop, interrupt
1.3.208 symbol-file, file
1.3.209 tbreak
1.3.210 thbreak
1.3.211 thread, core
1.3.212 thread apply, core apply
1.3.213 trace clear
1.3.214 trace dump
1.3.215 trace info
1.3.216 trace list
1.3.217 trace report
1.3.218 trace start
1.3.219 trace stop
1.3.220 unset
1.3.221 unsilence
1.3.222 up
1.3.223 up-silently
1.3.224 usecase help
1.3.225 usecase list
1.3.226 usecase run
1.3.227 wait
1.3.228 watch
1.3.229 watch-set-property
1.3.230 whatis
1.3.231 where, backtrace, info stack
1.3.232 while
1.3.233 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
0527-00 07 April 2017 Non-Confidential Document numbering scheme has changed. Update for DS-5 version 5.27.

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 100954_0527_00_en
Copyright © 2010–2017 ARM Limited or its affiliates. All rights reserved.