A.8.26. CADI::CADIMemGetOverlays()

The debugger calls this function to get the list of active overlays. This would typically be done when a breakpoint is hit. When overlays are implemented, an overlay ID must be stored in the symbol table and in the target software. The symbol table must store the starting address, memory space, and byte count for each overlay. This enables the ID to be sent to the host when an overlay occurs.

virtual CADIReturn_t CADI::CADIMemGetOverlays(uint32_t activeOverlayIndex,
                                           uint32_t desiredNumOfActiveOverlays,
                                           uint32_t* actualNumOfActiveOverlays,
                                           CADIOverlayId_t * overlays) =0;

where:

activeOverlayIndex

is the start index into the internal buffer of overlays held by the target.

desiredNumOfActiveOverlays

is the required number of overlays.

actualNumOfActiveOverlays

is the number of overlay structures returned by the target.

overlays

is the list of overlays that are currently memory resident (that is, swapped-in). The array is allocated, and deallocated if applicable, by the caller and filled by the target.

Copyright © 2008-2011 ARM. All rights reserved.ARM DUI 0444H
Non-ConfidentialID010512