A.2.4 Logical Group List

The <logical_group_list> section of the XML link information file is similar to the output section listing in a linker-generated map file. However, the XML link information file contains a specification of GROUP and UNION output sections, which are not represented in a map file. There are three kinds of list items that can occur in a <logical_group_list>:

• The <logical_group> is the specification of a section or GROUP that contains a list of object components or logical group members. Each <logical_group> element is given an id so that it may be referenced from other elements. Each <logical_group> is a container element enclosing the following elements:
  • The <name> element names the logical group (string).
  • The <load_address> element specifies the load-time address of the logical group (constant).
  • The <run_address> element specifies the run-time address of the logical group (constant).
  • The <size> element specifies the size of the logical group (constant).
  • The <contents> element lists elements contained in this logical group (container). These elements refer to each of the member objects contained in this logical group:
    • The <object_component_ref> is an object component that is contained in this logical group (reference).
    • The <logical_group_ref> is a logical group that is contained in this logical group (reference).

• The <overlay> is a special kind of logical group that represents a UNION, or a set of objects that share the same memory space (container). Each <overlay> element is given an id so that it may be referenced from other elements (like from an <allocated_space> element in the placement map). Each <overlay> contains the following elements:
  • The <name> element names the overlay (string).
  • The <run_address> element specifies the run-time address of overlay (constant).
  • The <size> element specifies the size of logical group (constant).
  • The <contents> container element lists elements contained in this overlay. These elements refer to each of the member objects contained in this logical group:
    • The <object_component_ref> is an object component that is contained in this logical group (reference).
    • The <logical_group_ref> is a logical group that is contained in this logical group (reference).

• The <split_section> is another special kind of logical group that represents a collection of logical groups that is split among multiple memory areas. Each <split_section> element is given an id so that it may be referenced from other elements. The id consists of the following elements.
  • The <name> element names the split section (string).
  • The <contents> container element lists elements contained in this split section. The <logical_group_ref> elements refer to each of the member objects contained in this split section, and each element referenced is a logical group that is contained in this split section (reference).