RealView ® Developer Kit Debugger CommandLine Reference Guide

Version 1.0


Table of Contents

Preface
About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback
Feedback on the RealView Developer Kit
Feedback on this book
1. Working with the CLI
1.1. About the CLI
1.1.1. Why use the CLI?
1.1.2. Accessing the CLI
1.1.3. Getting help
1.2. Using the CLI
1.2.1. Entering commands interactively
1.2.2. Entering batched commands
1.2.3. General command language syntax
1.2.4. Using expressions and statements
1.3. Converting legacy scripts to RealView Debugger format
1.4. Types of RealView Debugger expressions
1.5. Constructing expressions
1.5.1. Permitted symbol names
1.5.2. Program symbols
1.5.3. RealView Debugger variable symbols
1.5.4. Macro symbols
1.5.5. Reserved symbols
1.5.6. Addresses
1.5.7. Expression strings
1.5.8. Target functions
1.6. Using variables in the RealView Debugger
1.6.1. Scope
1.6.2. Data types
1.6.3. Root names
1.6.4. Module names
1.6.5. Variable references
1.6.6. Stack references
2. RealView Debugger Commands
2.1. RealView Debugger commands listed by function
2.1.1. Board file access
2.1.2. Execution control
2.1.3. Examining source files
2.1.4. Program image management
2.1.5. Target registers and memory
2.1.6. Status enquiries
2.1.7. Macros and aliases
2.1.8. CLI
2.1.9. Program symbol manipulation
2.1.10. Creating and writing to files andwindows
2.1.11. Miscellaneous
2.2. Alphabetical command reference
2.2.1. ADD
2.2.2. ADDBOARD
2.2.3. ADDFILE
2.2.4. ALIAS
2.2.5. ARGUMENTS
2.2.6. BACCESS
2.2.7. BEXECUTION
2.2.8. BGLOBAL
2.2.9. BINSTRUCTION
2.2.10. BREAD
2.2.11. BREAK
2.2.12. BREAKACCESS
2.2.13. BREAKEXECUTION
2.2.14. BREAKINSTRUCTION
2.2.15. BREAKREAD
2.2.16. BREAKWRITE
2.2.17. BROWSE
2.2.18. BWRITE
2.2.19. CANCEL
2.2.20. CEXPRESSION
2.2.21. CLEARBREAK
2.2.22. COMPARE
2.2.23. CONNECT
2.2.24. CONTEXT
2.2.25. COPY
2.2.26. DBOARD
2.2.27. DBREAK
2.2.28. DCOMMANDS
2.2.29. DEFINE
2.2.30. DELBOARD
2.2.31. DELETE
2.2.32. DELFILE
2.2.33. DHELP
2.2.34. DISABLEBREAK
2.2.35. DISASSEMBLE
2.2.36. DISCONNECT
2.2.37. DLOADERR
2.2.38. DMAP
2.2.39. DOWN
2.2.40. DTBOARD
2.2.41. DTBREAK
2.2.42. DTFILE
2.2.43. DTPROCESS
2.2.44. DUMP
2.2.45. DUMPMAP
2.2.46. DVFILE
2.2.47. DVPROCESS
2.2.48. EDITBOARDFILE
2.2.49. EMURESET
2.2.50. EMURST
2.2.51. ENABLEBREAK
2.2.52. ERROR
2.2.53. EXPAND
2.2.54. FAILINC
2.2.55. FILL
2.2.56. FLASH
2.2.57. FOPEN
2.2.58. FPRINTF
2.2.59. GO
2.2.60. GOSTEP
2.2.61. HALT
2.2.62. HELP
2.2.63. HWRESET
2.2.64. INCLUDE
2.2.65. JOURNAL
2.2.66. JUMP
2.2.67. LIST
2.2.68. LOAD
2.2.69. LOG
2.2.70. MACRO
2.2.71. MEMMAP
2.2.72. MEMWINDOW
2.2.73. MMAP
2.2.74. MODE
2.2.75. MONITOR
2.2.76. NAMETRANSLATE
2.2.77. NOMONITOR
2.2.78. ONSTATE
2.2.79. OPTION
2.2.80. PATHTRANSLATE
2.2.81. PAUSE
2.2.82. PRINTF
2.2.83. PRINTSYMBOLS
2.2.84. PRINTTYPE
2.2.85. PRINTVALUE
2.2.86. PROPERTIES
2.2.87. PS
2.2.88. PT
2.2.89. QUIT
2.2.90. READBOARDFILE
2.2.91. READFILE
2.2.92. REEXEC
2.2.93. RELOAD
2.2.94. RESET
2.2.95. RESETBREAKS
2.2.96. RESTART
2.2.97. RSTBREAKS
2.2.98. RUN
2.2.99. SCOPE
2.2.100. SEARCH
2.2.101. SETFLAGS
2.2.102. SETMEM
2.2.103. SETREG
2.2.104. SETTINGS
2.2.105. SHOW
2.2.106. SINSTR
2.2.107. SM
2.2.108. SOINSTR
2.2.109. SOVERLINE
2.2.110. SR
2.2.111. STEPINSTR
2.2.112. STEPLINE
2.2.113. STEPOINSTR
2.2.114. STEPO
2.2.115. STOP
2.2.116. TEST
2.2.117. THREAD
2.2.118. UNLOAD
2.2.119. UP
2.2.120. VCLEAR
2.2.121. VCLOSE
2.2.122. VERIFYFILE
2.2.123. VMACRO
2.2.124. VOPEN
2.2.125. VSETC
2.2.126. WAIT
2.2.127. WARMSTART
2.2.128. WHERE
2.2.129. WRITEFILE
3. Comparison of Commands
3.1. RealView Debugger, armsd, and AXD commands
3.1.1. AXD commands
3.1.2. armsd commands
Glossary

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarksowned by ARM Limited. Other brands and names mentioned herein maybe the trademarks of their respective owners.

Neither the whole nor any part of the information containedin, or the product described in, this document may be adapted orreproduced in any material form except with the prior written permissionof the copyright holder.

The product described in this document is subject to continuousdevelopments and improvements. All particulars of the product andits use contained in this document are given by ARM in good faith.However, all warranties implied or expressed, including but notlimited to implied warranties of merchantability, or fitness forpurpose, are excluded.

This document is intended only to assist the reader in theuse of the product. ARM Limited shall not be liable for any lossor damage arising from the use of any information in this document,or any error or omission in such information, or any incorrect useof the product.

ConfidentialityStatus

This document is Non-Confidential. The right to use, copyand disclose this document may be subject to license restrictionsin accordance with the terms of the agreement entered into by ARMand the party that ARM delivered this document to.

Product Status

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

Revision History
Revision A May 2003 Release for RVDK v1.0
Revision B March2004 Release for RVDK v1.0.1
Copyright © 2003, 2004 ARM Limited. All rights reserved. ARM DUI 0235B
Non-Confidential