beautypg.com

Invoking the linker – Zilog Z8F0130 User Manual

Page 370

background image

Using the Linker/Locator

UM013037-1212

346

Zilog Developer Studio II – Z8 Encore!
User Manual

A group is a collection of logical address spaces. They are typically used for conve-
nience of locating a set of address spaces.

Segments

Each address space consists of various segments. Segments are named logical parti-
tions of data or code that form a continuous block of memory. Segments with the same
name residing in different modules are concatenated together at link time. Segments
are assigned to an address space and can be relocatable or absolute. Relocatable seg-
ments can be randomly allocated by the linker; absolute segments are assigned a phys-
ical address within its address space. See the

Segments

section on page 279 for more

information about using predefined segments, defining new segments, and attaching
code and data to segments.

The linker performs the following functions:

Reads in relocatable object modules and library files and linker commands.

Resolves external references.

Assigns absolute addresses to relocatable segments of each address space and group.

Generates a single executable module to download into the target system.

Generates a map file.

Invoking the Linker

The linker is automatically invoked when your project is open and you click the Build but-
ton or Rebuild All button on the Build toolbar (see the

Build Toolbar

section on page 26).

The linker then links the corresponding object modules of the various source files in your
project and any additional object/library modules specified in the Objects and Libraries
page of the

Project Settings

dialog box (see the

Linker: Objects and Libraries Page

sec-

tion on page 98).The linker uses the linker command file to control how these object mod-
ules and libraries are linked. The linker command file is automatically generated by ZDS II
if the Always Generate from Settings button is selected (see the

Always Generate from

Settings

section on page 95). You can add additional linker commands by selecting the

Additional Directives

checkbox and clicking

Edit

(see the

Additional Directives

section

on page 96). If you want to override the automatically generated linker command file,
select the

Use Existing

button (see the

Use Existing

section on page 97).

The linker can also be invoked from the DOS command line or through the ZDS II Com-
mand Processor. For more information about invoking the linker from the DOS command
line, see the

Appendix C. Running ZDS II from the Command Line

section on page 479.

To invoke the linker through the ZDS II Command Processor, see

Appendix D. Using the

Command Processor

on page 489.