RealView® Debugger RTOS Guide

Version 3.0

Table of Contents

About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback on RealView Debugger
Feedback on this book
1. OS Support in RealView Debugger
1.1. About OS support in RealView Debugger
1.1.1. Debugging an OS-aware application with RealView Debugger
1.2. Hardware for OS support
1.3. OS debugging facilities available in RealView Debugger
1.3.1. Linux application debugging
1.3.2. Loading the .srec file for the Linux kernel
1.4. Halted System Debug and Running System Debug
1.5. Debug Agent
1.6. OS-aware CLI commands
2. Configuring OS-aware Connections
2.1. Enabling OS support
2.2. Creating a new OS-aware connection
2.2.1. Procedure
2.2.2. Configuring a RealView ICE interface unit
2.3. Configuring an OS-aware connection
2.3.1. Locating the OS related settings groups
2.3.2. OS configuration settings
2.3.3. Procedure for configuring RTOS_config settings
2.3.4. Procedure for configuring the ARM_config settings
2.3.5. Configuring the connect and disconnect options
2.4. Managing configuration settings
3. Connecting to an OS-aware Target and Loading an Image
3.1. Before connecting
3.2. Connecting from the Code window
3.3. Connecting to a running target
3.3.1. Specifying connect mode
3.3.2. Specifying disconnect mode
3.4. Loading an image to an OS-aware target
3.5. OS Exit Options
3.6. Interrupts when loading an image
3.7. Resetting OS state
3.8. Loading from the command line
4. Associating Threads with Views
4.1. Attaching and unattaching windows
4.2. The current thread
4.2.1. Using CLI commands for examining thread information
4.3. Using the Cycle Threads button
4.3.1. Viewing thread details
4.4. Working with the thread list
4.4.1. The thread list
4.4.2. Identifying the current thread
4.4.3. Captive threads
4.4.4. Attaching windows to threads
4.4.5. Using the thread List Selection dialog box
5. Working with OS-aware Images in the Process Control pane
5.1. The Process Control pane and OS-aware images
5.2. OS marker in the Process tab
5.2.1. OS marker initial state
5.2.2. OS marker with an OS-aware image loaded
5.2.3. OS marker for a running target with HSD fully operational
5.2.4. OS marker for a running target with RSD fully operational
5.2.5. OS marker status
5.2.6. Context menu
5.3. Examining thread details in the Thread tab
5.3.1. Thread icons
5.3.2. Special threads in the Thread tab
5.4. Changing the current thread and attachment
6. Viewing OS Resources
6.1. About viewing OS resources
6.2. Viewing details in the Output pane
6.3. Viewing details in a Properties dialog box
6.4. Viewing the active connections
6.5. Updating the Resource Viewer pane
6.5.1. Manually updating the Resource Viewer pane
6.5.2. Automatically updating the Resource Viewer pane
6.5.3. Automatically updating the details of a selected resource
6.6. Performing OS-specific actions on an OS-aware target
6.7. Interaction of OS resources and RealView Debugger
7. Debugging Your OS Application
7.1. About breakpoints
7.1.1. Using the break trigger group
7.1.2. More on breakpoints
7.2. Setting breakpoints
7.2.1. Procedure for setting a breakpoint in the code view
7.2.2. Breakpoint markers in the code views
7.2.3. Changing the break trigger group
7.3. Using the Create Breakpoint dialog box
7.4. Using the Break/Tracepoints pane
7.5. Capturing events and loading specific symbols
7.5.1. Basic procedure
7.5.2. Specifying filters for loading symbols based on process and module names
7.5.3. Specifying the events to capture
7.5.4. Viewing the object mappings
7.6. Stepping threads
7.6.1. Stepping in RSD mode
7.6.2. Stepping in HSD mode
7.7. Manipulating registers and variables
7.8. Updating your debug view

List of Figures

1.1. RealView Debugger and OS components
2.1. Connection Control window
2.2. CONNECTION groups in the Connection Properties window
2.3. Specifying a new CONNECTION group
2.4. New connection in the Connection Control window
2.5. RTOS_config group in the Connection Properties window
2.6. ARM_config group in the Connection Properties window
2.7. Default group in the Connection Properties window
3.1. Connection Control window
3.2. RTOS Exit Options List Selection dialog box
4.1. Example thread list
4.2. Example thread list in an attached window
4.3. Thread List Selection dialog box
5.1. OS marker initial state (OS plugin not loaded)
5.2. OS marker initial state (OS plugin loaded)
5.3. OS marker with loaded image (OS plugin loaded)
5.4. OS marker in the Process Control pane (HSD)
5.5. OS marker in the Process Control pane (RSD)
5.6. Thread tab in the Process Control pane
6.1. Resource Viewer pane
6.2. Resource Viewer pane showing the thread list
6.3. Thread details in the Output pane
6.4. Resource Viewer pane
6.5. Resource Viewer pane showing the thread list
6.6. Thread details in the Properties dialog box
6.7. Active connection in the Resource Viewer pane
6.8. Resource Viewer pane
6.9. Select resource in the Resource Viewer pane
6.10. Resource Viewer pane (RSD)
6.11. Action argument prompt
7.1. OS Breakpoint Class selector
7.2. OS (RSD) breakpoints in the Break/Tracepoints pane
7.3. OS (HSD) breakpoints in the Break/Tracepoints pane
7.4. Process and module symbols loaded
7.5. Debug Symbols - File Filter dialog box
7.6. Debug symbol filters defined
7.7. Event Filtering dialog box
7.8. Source Search and Mappings dialog box
7.9. Object Mapping tab
7.10. Stepping and stopping threads

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarks owned by ARM Limited. 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 Limited 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.

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 AMarch 2006RealView Debugger v3.0 release for RVDS v3.0
Copyright © 2006 ARM Limited. All rights reserved.ARM DUI 0323A