B.8.1 Header Elements

The first elements in the XML link information file provide general information about the linker and the link session:

• The <banner> element lists the name of the executable and the version information (string).
• The <copyright> element lists the TI copyright information (string).
• The <link_time> is a timestamp representation of the link time (unsigned 32-bit int).
• The <output_file> element lists the name of the linked output file generated (string).
• The <entry_point> element specifies the program entry point, as determined by the linker (container) with two entries:
  • The <name> is the entry point symbol name, if any (string).
  • The <address> is the entry point address (constant).

B.8.2 Input File List

The next section of the XML link information file is the input file list, which is delimited with a <input_file_list> container element. The <input_file_list> can contain any number of <input_file> elements.

Each <input_file> instance specifies the input file involved in the link. Each <input_file> has an id attribute that can be referenced by other elements, such as an <object_component>. An <input_file> is a container element enclosing the following elements:

• The <path> element names a directory path, if applicable (string).
• The <kind> element specifies a file type, either archive or object (string).
• The <file> element specifies an archive name or filename (string).
• The <name> element specifies an object file name, or archive member name (string).

B.8.3 Object Component List

The next section of the XML link information file contains a specification of all of the object components that are involved in the link. An example of an object component is an input section. In general, an object component is the smallest piece of object that can be manipulated by the linker.

The <object_component_list> is a container element enclosing any number of <object_component> elements.

Each <object_component> specifies a single object component. Each <object_component> has an id attribute so that it can be referenced directly from other elements, such as a <logical_group>. An <object_component> is a container element enclosing the following elements:

• The <name> element names the object component (string).
• The <load_address> element specifies the load-time address of the object component (constant).
• The <run_address> element specifies the run-time address of the object component (constant).
• The <size> element specifies the size of the object component (constant).
• The <input_file_ref> element specifies the source file where the object component originated (reference).

B.8.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).

B.8.5 Placement Map

The <placement_map> element describes the memory placement details of all named memory areas in the application, including unused spaces between logical groups that have been placed in a particular memory area.

The <memory_area> is a description of the placement details within a named memory area (container). The description consists of these items:

• The <name> names the memory area (string).
• The <page_id> gives the id of the memory page in which this memory area is defined (constant).
• The <origin> specifies the beginning address of the memory area (constant).
• The <length> specifies the length of the memory area (constant).
• The <used_space> specifies the amount of allocated space in this area (constant).
• The <unused_space> specifies the amount of available space in this area (constant).
• The <attributes> lists the RWXI attributes that are associated with this area, if any (string).
• The <fill_value> specifies the fill value that is to be placed in unused space, if the fill directive is specified with the memory area (constant).
• The <usage_details> lists details of each allocated or available fragment in this memory area. If the fragment is allocated to a logical group, then a <logical_group_ref> element is provided to facilitate access to the details of that logical group. All fragment specifications include <start_address> and <size> elements.
  • The <allocated_space> element provides details of an allocated fragment within this memory area (container):
    • The <start_address> specifies the address of the fragment (constant).
    • The <size> specifies the size of the fragment (constant).
    • The <logical_group_ref> provides a reference to the logical group that is allocated to this fragment (reference).
  • The <available_space element provides details of an available fragment within this memory area (container):
    • The <start_address> specifies the address of the fragment (constant).
    • The <size> specifies the size of the fragment (constant).

B.8.6 Far Call Trampoline List

The <far_call_trampoline_list> is a list of <far_call_trampoline> elements. The linker supports the generation of far call trampolines to help a call site reach a destination that is out of range. A far call trampoline function is guaranteed to reach the called function (callee) as it may utilize an indirect call to the called function.

The <far_call_trampoline_list> enumerates all of the far call trampolines that are generated by the linker for a particular link. The <far_call_trampoline_list> can contain any number of <far_call_trampoline> elements. Each <far_call_trampoline> is a container enclosing the following elements:

• The <callee_name> element names the destination function (string).
• The <callee_address> is the address of the called function (constant).
• The <trampoline_object_component_ref> is a reference to an object component that contains the definition of the trampoline function (reference).
• The <trampoline_address> is the address of the trampoline function (constant).
• The <caller_list> enumerates all call sites that utilize this trampoline to reach the called function (container).
• The <trampoline_call_site> provides the details of a trampoline call site (container) and consists of these items:
  • The <caller_address> specifies the call site address (constant).
  • The <caller_object_component_ref> is the object component where the call site resides (reference).

B.8.7 Symbol Table

The <symbol_table> contains a list of all of the global symbols that are included in the link. The list provides information about a symbol's name and value. In the future, the symbol_table list may provide type information, the object component in which the symbol is defined, storage class, etc.

The <symbol> is a container element that specifies the name and value of a symbol with these elements:

• The <name> element specifies the symbol name (string).
• The <value> element specifies the symbol value (constant).