Preface

About this manual
Intended audience
Using this manual
Further reading
Feedback
Feedback on RealView Profiler
Feedback on this book

The preface introduces you to the RealView Profiler documentation. It provides a list of all of the User Guide sections with an overview of what information each section contains, a list of typographical conventions used in this document, and a selected list of other pertinent ARM documentation.

It contains the following sections:

About this manual

This document describes the functionality of RealView Profiler, providing information about its use and a detailed reference on every data type contained in a RealView Profiler-generated analysis report.

Intended audience

This manual is written for developers who intend to use RealView Profiler to profile their code against their ARM-powered systems. In order to get the most out of the toolset and this documentation, you should have a working knowledge of ARM's compiler and how to use it to generate image files, and either a system model created using RealView System Generator or the RealView ICE and RealView Trace 2 hardware set up to collect runtime profiling data. A working knowledge of the C programming language and C terminology is essential for using RealView Profiler and understanding this manual.

Using this manual

This user's manual is broken up into the following chapters:

Chapter 1 Introduction

Chapter one gives you a high level overview of RealView Profiler's features and provides information about additional resources.

Chapter 2 Data Collection Using RealView Trace 2

Chapter two describes the process of gathering profiling data using the RealView ICE and RealView Trace 2 hardware.

Chapter 3 Data Collection Using a Real Time System Model

Chapter three of the user's manual illustrates how to gather analysis data using a Real Time System Model created using RealView System Generator.

Chapter 4 The Summary Report

Chapter four outlines RealView Profiler's reporting interface, describes the Summary Report in detail, and shows you the navigation options to all of the various report types.

Chapter 5 The Table Reports: Function, File, Class, and Call Chain

Chapter five focuses on the various table reports of RealView Profiler. It describes each of the report fields and how to sort and manage the data.

Chapter 6 The Code View

Chapter six provides a complete look at the code view, a report that shows detailed information about the line-by-line execution and performance of a single function.

Chapter 7 The Call Graph

Chapter seven describes the functionality of the call graph and how you can use it to pinpoint bottlenecks.

Chapter 8 The Call Summary

Chapter eight provides a detailed description of how to use the call summary to explore your code.

Chapter 9 Merging Analysis Reports

Chapter nine shows you how to merge analysis reports into a single file.

Chapter 10 Preferences

Chapter ten details each of RealView Profiler's preferences and how to set them.

Appendix A Command Line Options

Reference this Appendix for descriptions of each of RealView Profiler's available command line options.

Appendix B RealView Profiler Keyboard Shortcuts

Appendix B details all of the keyboard shortcuts in each of RealView Profiler report types.

Appendix C RealView Profiler Hardware Troubleshooting Guide

Appendix C lists the most common causes for hardware profiling failure.

Further reading

This section lists publications by ARM Limited, and by third parties, that are related to this product.

ARM Limited periodically provides updates and corrections to its documentation. See http://www.arm.com for current errata sheets, addenda, and the ARM Frequently Asked Questions list.

ARM publications

In addition to the user's manual, information pertinent to this release of RealView Profiler can be found in:

See the following documentation for details of the FLEXlm license management system, supplied by GLOBEtrotter Inc., which controls the use of ARM applications:

Refer to the following documentation for information relating to the use of RealView ICE in conjunction with RealView Trace 2 for hardware data collection:

In order to gather analysis results, you'll need to build an ARM executable using the ARM compilation tools. See the following documentation for a thorough understanding of how to use them:

Feedback

ARM Limited welcomes feedback on both RealView Profiler and its documentation.

Feedback on RealView Profiler

If you have any problems with RealView Profiler, contact your supplier. To help them provide a rapid and useful response, give:

Feedback on this book

If you have any comments on this book, send email to errata@arm.com giving:

General suggestions for additions and improvements are also welcome.

Copyright © 2007 ARM Limited. All rights reserved. ARM DUI 0412A