RealView® Debugger Command Line Reference Guide

Version 4.1


Table of Contents

Preface
About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback
Feedback on this product
Feedback on this book
1. Working with the CLI
1.1. General command language syntax
1.1.1. General syntax rules
1.1.2. Command qualifiers and flags
1.1.3. Command parameters
1.1.4. Abbreviations
1.2. Window and file numbers
1.3. Using expressions and statements
1.3.1. Expressions
1.3.2. Keywords
1.3.3. Predefined macros
1.4. Command scripts
1.4.1. Considerations when using command scripts
1.4.2. Command script comments
1.4.3. Example command script
1.5. Macro language
1.5.1. Macro definition
1.5.2. Macro body
1.5.3. Macro terminator
1.5.4. Macro comments
1.5.5. Macro local symbols
1.6. Constructing expressions
1.6.1. Types of debugger expressions
1.6.2. Permitted symbol names
1.6.3. Program symbols
1.6.4. Debugger variable symbols
1.6.5. Macro symbols
1.6.6. Reserved symbols
1.6.7. Operations on symbols and registers
1.6.8. Addresses
1.6.9. Expression strings
1.7. Using variables in the debugger
1.7.1. Scope
1.7.2. Data types
1.7.3. Root names
1.7.4. Module names
1.7.5. Variable references
1.7.6. Stack references
1.8. Source patching with macros
1.8.1. Patching example to insert lines of source code
1.8.2. Patching example to jump over lines of source code
1.8.3. Patching example to re-implement a loop
1.8.4. Patching example to emulate a serial port
1.8.5. Other ways to use macros
2. RealView Debugger Commands
2.1. Command syntax definition
2.1.1. Specifying address ranges
2.2. Debugger commands listed by function
2.2.1. Board file access
2.2.2. Execution control
2.2.3. Examining source files
2.2.4. Program image management
2.2.5. Target registers and memory
2.2.6. Cache enquiries
2.2.7. Status enquiries
2.2.8. Macros and aliases
2.2.9. CLI
2.2.10. Program symbol manipulation
2.2.11. Creating and writing to files and windows
2.2.12. Processor tracing
2.2.13. OS-aware debugging
2.2.14. Miscellaneous
2.3. Alphabetical command reference
2.3.1. ADD
2.3.2. ADDFILE
2.3.3. ALIAS
2.3.4. ANALYZER
2.3.5. AOS_resource_list
2.3.6. ARGUMENTS
2.3.7. BACCESS
2.3.8. BEXECUTION
2.3.9. BGLOBAL
2.3.10. BINSTRUCTION
2.3.11. BOARD
2.3.12. BREAD
2.3.13. BREAK
2.3.14. BREAKACCESS
2.3.15. BREAKEXECUTION
2.3.16. BREAKINSTRUCTION
2.3.17. BREAKREAD
2.3.18. BREAKWRITE
2.3.19. BROWSE
2.3.20. BWRITE
2.3.21. CACHEFIND
2.3.22. CACHEINFO
2.3.23. CACHELINE
2.3.24. CANCEL
2.3.25. CCTRL
2.3.26. CEXPRESSION
2.3.27. CLEARBREAK
2.3.28. COMPARE
2.3.29. CONNECT
2.3.30. CONTEXT
2.3.31. COPY
2.3.32. COREINFO
2.3.33. CORESTATE
2.3.34. CWD
2.3.35. DBOARD
2.3.36. DBREAK
2.3.37. DCOMMANDS
2.3.38. DEFINE
2.3.39. DELBOARD
2.3.40. DELETE
2.3.41. DELFILE
2.3.42. DHELP
2.3.43. DISABLEBREAK
2.3.44. DISASSEMBLE
2.3.45. DISCONNECT
2.3.46. DLOADERR
2.3.47. DMAP
2.3.48. DOS_resource_list
2.3.49. DOWN
2.3.50. DTBOARD
2.3.51. DTBREAK
2.3.52. DTFILE
2.3.53. DTRACE
2.3.54. DUMP
2.3.55. DUMPMAP
2.3.56. DVFILE
2.3.57. EDITBOARDFILE
2.3.58. EMURESET
2.3.59. EMURST
2.3.60. ENABLEBREAK
2.3.61. ERROR
2.3.62. ETM_CONFIG
2.3.63. EXPAND
2.3.64. FAILINC
2.3.65. FILL
2.3.66. FLASH
2.3.67. FOPEN
2.3.68. FPRINTF
2.3.69. GO
2.3.70. GOSTEP
2.3.71. HALT
2.3.72. HELP
2.3.73. HOST
2.3.74. HWRESET
2.3.75. INCLUDE
2.3.76. INTRPT
2.3.77. JOURNAL
2.3.78. JUMP
2.3.79. LIST
2.3.80. LOAD
2.3.81. LOG
2.3.82. MACRO
2.3.83. MEMMAP
2.3.84. MEMWINDOW
2.3.85. MMAP
2.3.86. MODE
2.3.87. MONITOR
2.3.88. NOMONITOR
2.3.89. ONSTATE
2.3.90. OPTION
2.3.91. OS action commands
2.3.92. OS resource commands
2.3.93. OSCTRL
2.3.94. PAUSE
2.3.95. PRINTDSM
2.3.96. PRINTF
2.3.97. PRINTSYMBOLS
2.3.98. PRINTTYPE
2.3.99. PRINTVALUE
2.3.100. PROPERTIES
2.3.101. PS
2.3.102. PT
2.3.103. PWD
2.3.104. QUIT
2.3.105. READBOARDFILE
2.3.106. READFILE
2.3.107. REEXEC
2.3.108. REGINFO
2.3.109. RELOAD
2.3.110. RESET
2.3.111. RESETBREAKS
2.3.112. RESTART
2.3.113. RSTBREAKS
2.3.114. RUN
2.3.115. RVDCONTEXT
2.3.116. SCOPE
2.3.117. SEARCH
2.3.118. SETFLAGS
2.3.119. SETMEM
2.3.120. SETREG
2.3.121. SETTINGS
2.3.122. SHOW
2.3.123. SINSTR
2.3.124. SM
2.3.125. SOINSTR
2.3.126. SOVERLINE
2.3.127. SR
2.3.128. STATS
2.3.129. STDIOLOG
2.3.130. STEPINSTR
2.3.131. STEPLINE
2.3.132. STEPOINSTR
2.3.133. STEPO
2.3.134. STOP
2.3.135. SYNCHACTION
2.3.136. SYNCHEXEC
2.3.137. TEST
2.3.138. THREAD
2.3.139. TRACE
2.3.140. TRACEBUFFER
2.3.141. TRACEDATAACCESS
2.3.142. TRACEDATAREAD
2.3.143. TRACEDATAWRITE
2.3.144. TRACEEXTCOND
2.3.145. TRACEINSTREXEC
2.3.146. TRACEINSTRFETCH
2.3.147. UNLOAD
2.3.148. UP
2.3.149. VA2PA
2.3.150. VCLEAR
2.3.151. VCLOSE
2.3.152. VERIFYFILE
2.3.153. VMACRO
2.3.154. VOPEN
2.3.155. VSETC
2.3.156. WAIT
2.3.157. WARMSTART
2.3.158. WHERE
2.3.159. WINDOW
2.3.160. WRITEFILE
2.3.161. XTRIGGER
3. RealView Debugger Predefined Macros
3.1. Predefined macros listed by function
3.1.1. Access data values at an address
3.1.2. Flow control statements
3.1.3. File and window access
3.1.4. String manipulation
3.1.5. Memory manipulation
3.1.6. Cache statistics
3.1.7. User interaction macros
3.1.8. Miscellaneous
3.2. Alphabetical predefined macro reference
3.2.1. atoi
3.2.2. atol
3.2.3. atoul
3.2.4. byte
3.2.5. cache_find_set
3.2.6. cache_find_way
3.2.7. dword
3.2.8. error
3.2.9. fclose
3.2.10. fgetc
3.2.11. fopen
3.2.12. fputc
3.2.13. fread
3.2.14. fwrite
3.2.15. getsym
3.2.16. isdigit
3.2.17. islower
3.2.18. isprint
3.2.19. isspace
3.2.20. isupper
3.2.21. itoa
3.2.22. memchr
3.2.23. memclr
3.2.24. memcpy
3.2.25. memset
3.2.26. prompt_file
3.2.27. prompt_list
3.2.28. prompt_text
3.2.29. prompt_yesno
3.2.30. prompt_yesno_cancel
3.2.31. reg_str
3.2.32. strcat
3.2.33. strchr
3.2.34. strcmp
3.2.35. strcpy
3.2.36. stricmp
3.2.37. strlen
3.2.38. strncmp
3.2.39. strtolower
3.2.40. strtoupper
3.2.41. strtrim
3.2.42. tolower
3.2.43. toupper
3.2.44. until
3.2.45. when
3.2.46. word
4. RealView Debugger Keywords
4.1. Keywords listed by function
4.1.1. Data type keywords
4.1.2. Conditional statement keywords
4.1.3. Flow control keywords
4.1.4. Miscellaneous keywords
4.2. Alphabetical keyword reference
4.2.1. break
4.2.2. continue
4.2.3. do-while
4.2.4. for
4.2.5. if
4.2.6. if-else
4.2.7. isalive
4.2.8. return
4.2.9. sizeof
4.2.10. while

List of Tables

1.1. Types of CLI expressions
1.2. Qualified symbol references
1.3. Reserved symbols
1.4. Format specifiers for printing reserved symbols
1.5. Common processor core register symbols
1.6. Extended CPSR and SPSR processor core register symbols
1.7. Register operations
1.8. Address expressions
1.9. Examples of expression strings
1.10. Equivalent RealView Debugger data types for ARM assembler
1.11. Special casting types
1.12. Examples of references to variables
1.13. C operators for referencing and dereferencing variables
1.14. Macros for interacting with files and windows
1.15. Commands that run macros automatically
1.16. Commands that enable you to manage macros
1.17. Macros for interacting with a user
2.1. Board file access commands
2.2. Execution control commands
2.3. Examining source file commands
2.4. Program image management commands
2.5. Target register and memory access commands
2.6. Cache enquiry commands
2.7. Status enquiry commands
2.8. Macro and alias commands
2.9. CLI commands
2.10. Program symbol manipulation commands
2.11. Creating files and text writing commands
2.12. Processor tracing commands
2.13. OS-aware specific debugging commands
2.14. Debugging commands with OS-aware related features
2.15. Miscellaneous commands
2.16. Changed argument assignments
2.17. Example hw_in test strings for an ARM940T
2.18. Example hw_in test strings for an ARM940T
2.19. Example hw_in test strings for an ARM940T
2.20. Example hw_in test strings for an ARM940T
2.21. Configuration file extensions for each Debug Interface
2.22. External condition events
3.1. Access data value macros
3.2. Flow control statements
3.3. File and window access macros
3.4. String manipulation
3.5. Memory Manipulation macros
3.6. Cache statistics macros
3.7. User interaction macros
3.8. Miscellaneous macros
3.9. Error classes
4.1. Data type keywords
4.2. Conditional statement keywords
4.3. Flow control keywords
4.4. Miscellaneous keywords

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.

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”.

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.

Product Status

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

Revision History
Revision AApril 2002Release v1.5
Revision BSeptember 2002Release v1.6
Revision CFebruary 2003Release v1.6.1
Revision DSeptember 2003Release v1.6.1 for RealView Developer Suite v2.0
Revision EJanuary 2004Release v1.7 for RealView Developer Suite v2.1
Revision FDecember 2004Release v1.8 for RealView Developer Suite v2.2
Revision GMay 2005Release v1.8 SP1 for RealView Developer Suite v2.2 SP1
Revision HMarch 2006Release v3.0 for RealView Development Suite v3.0
Revision IMarch 2007Release v3.1 for RealView Development Suite v3.1
Revision JSeptember 2008Release v4.0 for RealView Development Suite v4.0
Revision K27 March 2009Release v4.0 SP1 for RealView Development Suite v4.0
Revision L28 May 2010Release 4.1 for RealView Development Suite v4.1
Revision M30 September 2010Release 4.1 SP1 for RealView Development Suite v4.1 SP1
Revision N31 May 2011Release 4.1 SP2 for RealView Development Suite v4.1 SP2
Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111