Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 User Manual
Product codes
SW006021-1
Linker
2012 Microchip Technology Inc.
DS52053B-page 279
7.2.1
-Aclass
=
low-high
,...
Normally psects are linked according to the information given to a -P option (see
Section 7.2.19 “-Pspec”) but sometimes it is desirable to have a class of psects linked
into more than one non-contiguous address range. This option allows a number of
address ranges to be specified as a class. For example:
Section 7.2.19 “-Pspec”) but sometimes it is desirable to have a class of psects linked
into more than one non-contiguous address range. This option allows a number of
address ranges to be specified as a class. For example:
-ACODE=1020h-7FFEh,8000h-BFFEh
specifies that psects in the class CODE are to be linked into the given address ranges,
unless they are specifically linked otherwise.
unless they are specifically linked otherwise.
Where there are a number of identical, contiguous address ranges, they may be
specified with a repeat count following an x character. For example:
specified with a repeat count following an x character. For example:
-ACODE=0-0FFFFhx16
specifies that there are 16 contiguous ranges, each 64k bytes in size, starting from
address zero. Even though the ranges are contiguous, no psect will straddle a 64k
boundary, thus this may result in different psect placement to the case where the option
address zero. Even though the ranges are contiguous, no psect will straddle a 64k
boundary, thus this may result in different psect placement to the case where the option
-ACODE=0-0FFFFFh
had been specified, which does not include boundaries on 64k multiples.
The -A option does not specify the memory space associated with the address. Once
a psect is allocated to a class, the space value of the psect is then assigned to the
class, see Section 6.4.9.3.13 “Space”.
a psect is allocated to a class, the space value of the psect is then assigned to the
class, see Section 6.4.9.3.13 “Space”.
7.2.2
-Cx
This option is now obsolete.
7.2.3
-Cpsect=class
This option will allow a psect to be associated with a specific class. Normally this is not
required on the command line since psect classes are specified in object files. See
Section 6.4.9.3.3 “Class”.
required on the command line since psect classes are specified in object files. See
Section 6.4.9.3.3 “Class”.
7.2.4
-Dclass=delta
This option allows the delta value for psects that are members of the specified class to
be defined. The delta value should be a number and represents the number of bytes
per addressable unit of objects within the psects. Most psects do not need this option
as they are defined with a delta value. See Section 6.4.9.3.4 “Delta”.
be defined. The delta value should be a number and represents the number of bytes
per addressable unit of objects within the psects. Most psects do not need this option
as they are defined with a delta value. See Section 6.4.9.3.4 “Delta”.
7.2.5
-Dsymfile
Use this option to produce an old-style symbol file. An old-style symbol file is an ASCII
file, where each line has the link address of the symbol followed by the symbol name.
file, where each line has the link address of the symbol followed by the symbol name.
7.2.6
-Eerrfile
Error messages from the linker are written to the standard error stream. Under DOS
there is no convenient way to redirect this to a file (the compiler drivers will redirect
standard error if standard output is redirected). This option will make the linker write all
error messages to the specified file instead of the screen, which is the default standard
error destination.
there is no convenient way to redirect this to a file (the compiler drivers will redirect
standard error if standard output is redirected). This option will make the linker write all
error messages to the specified file instead of the screen, which is the default standard
error destination.