C6000 Assembly Language Tools Errata

7.4.16 Make All Global Symbols Static (--make_static Option)

For an expanded explanation on the --make_static, or -h, please refer to Managing Symbols with the Linker.

7.5.4.3 Specifying Input Sections

In versions of the documentation prior to 7.4.0, the description of the input section specification syntax was not very thorough. Specifically, the use of hyphens or special characters in the path name and/or file name of an input section specification should be enclosde in quotes. The relevant section of the documentation has since been updated to include the following ...

You can explicitly specify the input sections that form an output section. Each input section is identified by its filename and section name. If the filename is hyphenated (or contains special characters), enclose it within qoutes:

  SECTIONS 
  {
     .text :                       /* Build .text output section                         */
     {
        f1.obj(.text)              /* Link .text section from f1.obj                     */
        f2.obj(sec1)               /* Link sec1 section from f2.obj                      */
        "f3-new.obj"               /* Link all sections from f3-new.obj                  */ 
        "ext-dir/f3ext.obj"(.text) /* Hyphenated path names should be enclosed in quotes */
        f4.obj(.text,sec2)         /* Link .text and sec2 from f4.obj                    */
     }
  }

Appendix A, Section A.5, Structuring Relocation Information

COFF file relocation information entries use a 12-byte format, not a 10-byte format. The structure is:

Byte Number	Type	Description
0-3	Long	Virtual address of the reference
4-7	Long	Symbol table index
8-9	Unsigned short	Reserved
10-11	Unsigned short	Relocation type

Section 7.5.4.5 Specifying Library or Archive Members as Input to Output Sections

The syntax for allocating archived library members specifically inside of a SECTIONS directive is not correct in the documentation. The ONLY syntax allowed is:

[-l] library name <member1, member2, ...> [(input sections0}

The documentation incorrectly lists an "=" character after -l. As an example:

.rtstry > RAM
{
   -lrtsXX.lib (.text)
}