Linker lk63

Development Tools

Outline

 

 

 

 

 

 

 

 

Links the relocatable objects created by the assembler by fixing
the memory locations, and creates executable absolute object
codes. The linker also provides a branch optimization function that
automatically inserts, deletes or corrects extension codes for
branch instructions.

 

 

 

 

 

Flowchart

from Assembler

 

 

 

 

 

 

 

 

Linker

Relocatable

ICE

 

 

 

command file

object file(s)

parameter file

 

 

 

file.cm

file.o

file.par

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Linker

 

 

 

 

 

 

 

 

lk63

 

 

 

 

 

 

 

 

 

 

 

 

 

file.map

file.sym

file.abs

file.xrf

file.als

lk63.err

Link

Symbol

Absolute

Cross

Absolute

Error file

map file

file

object file

reference file

list file

 

 

 

 

to Debugger

 

 

 

 

 

Start-up Command Usage

 

 

 

 

 

Usage: lk63 [options] <file names>

 

 

Options: -d

 

 

 

Disable all branch optimization

 

-di

 

 

 

Disable insertion of branch extension

 

-dr

 

 

 

Disable removal branch optimization

 

-e

 

 

 

Output error log file (.ERR)

 

-g

 

 

 

Add source debug information

 

-l

 

 

 

Output absolute list file (.ALS)

 

-m

 

 

 

Output map file (.MAP)

 

-o <file name>

 

 

Specify output file name

 

-s

 

 

 

Output symbol file (.SYM)

 

-x

 

 

 

Output cross reference file (.XRF)

Error Messages Branch destination too far from <address> CALZ for non zero page at <address>

Cannot create absolute object file <FILE NAME> Cannot open <file kind> file <FILE NAME> Cannot read <file kind> file <FILE NAME> Cannot relocate <section kind> section of <FILE NAME> Cannot write <file kind> file <FILE NAME> Illegal address range <address> for a code at <address> Illegal file name <FILE NAME> Illegal file name <FILE NAME> specified with option <option> Illegal ICE parameter at line <line number> of <FILE NAME> Illegal object <FILE NAME> Illegal option <option> No address specified with option <option> No code to locate No ICE parameter file specified No name and address specified with option <option> No object file specified Out of memory <section kind> section <address>-<address> overlaps with <section kind> section <address>-<address> <section kind> section <address>-<address> overlaps with the unavailable memory Unresolved external <label> in <FILE NAME> Unusable instruction code <instruction code> in <FILE NAME>

The branch destination address is out of range. The specified address is out of the range (0x0000–0x00ff). The absolute object file cannot be created. The file cannot be opened. The file cannot be read. The relocatable section cannot be allocated.

Data cannot be written to the file. The address specified by TST/SET/CLR is out of the range (0x0000–0x003f or 0xffC0–0xffff). The file name is incorrect. The file name specified with the option is incorrect.

The ICE parameter file contains an illegal parameter setting. The input file is not an object file in IEEE-695 format. An illegal option is specified. Address is not specified with the option. There is no valid code for mapping. ICE parameter file is not specified. Name and address are not specified with the option.

Object files to be linked are not specified. Cannot secure memory space. The address range of the section overlaps with another section's address range.

The address range of the section overlaps with the unavailable memory. Reference was made to an undefined symbol. The object contains an instruction invalid for the model.

-code <address>

Specify CODE

start address

-data <address>

Specify DATA

start address

-bss <address>

Specify BSS start address

-rcode <file name>=<address>

Specify CODE

start address of the file

-rdata <file name>=<address>

Specify DATA

start address of the file

-rbss <file name>=<address>

Specify BSS

start address of the file

-defsym <symbol>=<address>

Define symbol address

File names: Relocatable object file (.O)

 

Command parameter file (.CM)

 

ICE parameter file (.PAR)

 

 

Warning Messages Cannot create <file kind file <FILE NAME> Cannot open <file kind> file <FILE NAME> No debug information in <FILE NAME> No symbols found Second definition of label <label> in <FILE NAME> Second ICE parameter file <FILE NAME> ignored

The file cannot be created. The file cannot be opened. Debugging information is not included in the file. Symbols cannot be found. The label has already been defined.

Two or more ICE parameter files are specified.