RealView Debugger User Guide - ARM Information Center

Working with Macros9.1 About macrosMacros are interpreted C code running on the host with access to target memory andsymbols, user-defined debugger symbols (in host or target memory), and debuggerfunctions. Macros can access debugger variables, external windows and programs, andcan be attached to breakpoints, aliases, and windows.A macro can contain:• a sequence of expressions• string formatting controls• statements• calls to other macros• predefined macros• target functions• debugger commands.You can define and use macros at any time during a debugging session to use thecommands or statements contained in the macro. You call the macro with a singlecommand using the name. The macro definition might contain parameters that youchange each time the macro is called.When a macro is defined, you can use it as:• a complex command or in an expression• an attachment to a breakpoint to create breakpoint condition testing• an attachment to a window or file where the macro can send information.NoteAfter a macro has been loaded into RealView Debugger, the definition is stored in thesymbol table. If the symbol table is recreated, for example when an image is loaded withsymbols, any macros are automatically deleted. Disconnecting also clears any macros.This section gives an overview of macros in RealView Debugger. It includes thefollowing sections:• Properties of macros on page 9-3• Debugger commands in macros on page 9-3• Defining macros on page 9-5• Calling macros on page 9-5• Macro return values on page 9-6• Using macros with breakpoints on page 9-6• Attaching macros on page 9-7• Stopping macros on page 9-7.9-2 Copyright © 2002-2005 ARM Limited. All rights reserved. ARM DUI 0153G