A.8.15 CADI::CADIRegGetGroups()

This call retrieves register groups from the target.

virtual CADIReturn_t CADI::CADIRegGetGroups(uint32_t groupIndex, 
                                            uint32_t desiredNumOfRegGroups,
                                            uint32_t *actualNumOfRegGroups,
                                            CADIRegGroup_t *reg) = 0;
is the index into the internal list of register groups as maintained by the target. It is not the group IDs.
is the size of the reg[] buffer provided by the caller.
is, on return, the number of groups that have actually been returned by the target. If this is less than the number requested, the debugger might call this function again with a different groupIndex. Any value set on input is ignored.

is the register group information. The array is allocated, and deallocated if applicable, by the caller and filled by the target:

  • The amount of space allocated must be enough to hold the number of groups required.
  • If the required count is greater than the targets total number of register groups, the target must return all groups.
  • If fewer groups are returned than requested, the last entries of the reg[] array are left empty.
Non-ConfidentialPDF file icon PDF versionARM 100963_0200_00_en
Copyright © 2014–2017 ARM Limited or its affiliates. All rights reserved.