Added docs for search paths.
Removed builtin configs - It's too difficult to keep them up-to-date. git-svn-id: svn://svn.cc65.org/cc65/trunk@2179 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
cuz
432
doc/ld65.sgml
432
doc/ld65.sgml
@@ -55,25 +55,31 @@ The linker is called as follows:
|
|||||||
---------------------------------------------------------------------------
|
---------------------------------------------------------------------------
|
||||||
Usage: ld65 [options] module ...
|
Usage: ld65 [options] module ...
|
||||||
Short options:
|
Short options:
|
||||||
-C name Use linker config file
|
-C name Use linker config file
|
||||||
-Ln name Create a VICE label file
|
-L path Specify a library search path
|
||||||
-Lp Mark write protected segments as such (VICE)
|
-Ln name Create a VICE label file
|
||||||
-S addr Set the default start address
|
-Lp Mark write protected segments as such (VICE)
|
||||||
-V Print the linker version
|
-S addr Set the default start address
|
||||||
-h Help (this text)
|
-V Print the linker version
|
||||||
-m name Create a map file
|
-h Help (this text)
|
||||||
-o name Name the default output file
|
-m name Create a map file
|
||||||
-t sys Set the target system
|
-o name Name the default output file
|
||||||
-v Verbose mode
|
-t sys Set the target system
|
||||||
-vm Verbose map file
|
-v Verbose mode
|
||||||
|
-vm Verbose map file
|
||||||
|
|
||||||
Long options:
|
Long options:
|
||||||
--config name Use linker config file
|
--cfg-path path Specify a config file search path
|
||||||
--help Help (this text)
|
--config name Use linker config file
|
||||||
--mapfile name Create a map file
|
--dump-config name Dump a builtin configuration
|
||||||
|
--help Help (this text)
|
||||||
|
--lib-path path Specify a library search path
|
||||||
|
--mapfile name Create a map file
|
||||||
|
--module-id id Specify a module id
|
||||||
|
--obj-path path Specify an object file search path
|
||||||
--start-addr addr Set the default start address
|
--start-addr addr Set the default start address
|
||||||
--target sys Set the target system
|
--target sys Set the target system
|
||||||
--version Print the linker version
|
--version Print the linker version
|
||||||
---------------------------------------------------------------------------
|
---------------------------------------------------------------------------
|
||||||
</verb></tscreen>
|
</verb></tscreen>
|
||||||
|
|
||||||
@@ -129,11 +135,13 @@ Here is a description of all the command line options:
|
|||||||
<item>cbm610 (all CBM series-II computers with 80 column video)
|
<item>cbm610 (all CBM series-II computers with 80 column video)
|
||||||
<item>pet (all CBM PET systems except the 2001)
|
<item>pet (all CBM PET systems except the 2001)
|
||||||
<item>geos
|
<item>geos
|
||||||
|
<item>lunix
|
||||||
|
<item>atmos
|
||||||
|
<item>nes
|
||||||
</itemize>
|
</itemize>
|
||||||
|
|
||||||
There are a few more targets defined but neither of them is actually
|
There are a few more targets defined but neither of them is actually
|
||||||
supported. See <ref id="builtin-configs" name="builtin configurations"> for
|
supported.
|
||||||
more information.
|
|
||||||
|
|
||||||
|
|
||||||
<label id="option-v">
|
<label id="option-v">
|
||||||
@@ -161,6 +169,14 @@ Here is a description of all the command line options:
|
|||||||
id="option-t" name="-t"></tt>.
|
id="option-t" name="-t"></tt>.
|
||||||
|
|
||||||
|
|
||||||
|
<tag><tt>-L path, --lib-path path</tt></tag>
|
||||||
|
|
||||||
|
Specify a library search path. This option may be used more than once. It
|
||||||
|
adds a directory to the search path for library files. Libraries specified
|
||||||
|
without a path are searched in current directory and in the list of
|
||||||
|
directories specified using <tt/--lib-path/.
|
||||||
|
|
||||||
|
|
||||||
<tag><tt>-Ln</tt></tag>
|
<tag><tt>-Ln</tt></tag>
|
||||||
|
|
||||||
This option allows you to create a file that contains all global labels and
|
This option allows you to create a file that contains all global labels and
|
||||||
@@ -189,6 +205,23 @@ Here is a description of all the command line options:
|
|||||||
This option print the version number of the linker. If you send any
|
This option print the version number of the linker. If you send any
|
||||||
suggestions or bugfixes, please include this number.
|
suggestions or bugfixes, please include this number.
|
||||||
|
|
||||||
|
|
||||||
|
<tag><tt>--cfg-path path</tt></tag>
|
||||||
|
|
||||||
|
Specify a config file search path. This option may be used more than once.
|
||||||
|
It adds a directory to the search path for config files. A config file given
|
||||||
|
with the <tt><ref id="option-C" name="-C"></tt> option that has no path in
|
||||||
|
its name is searched in the current directory and in the list of directories
|
||||||
|
specified using <tt/--cfg-path/.
|
||||||
|
|
||||||
|
|
||||||
|
<tag><tt>--obj-path path</tt></tag>
|
||||||
|
|
||||||
|
Specify an object file search path. This option may be used more than once.
|
||||||
|
It adds a directory to the search path for object files. An object file
|
||||||
|
passed to the linker that has no path in its name is searched in current
|
||||||
|
directory and in the list of directories specified using <tt/--obj-path/.
|
||||||
|
|
||||||
</descrip>
|
</descrip>
|
||||||
|
|
||||||
If one of the modules is not found in the current directory, and the module
|
If one of the modules is not found in the current directory, and the module
|
||||||
@@ -730,363 +763,14 @@ url="ca65.html" name="ca65 manual">.
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
<sect1>Builtin configurations<label id="builtin-configs"><p>
|
<sect1>Builtin configurations<p>
|
||||||
|
|
||||||
Here is a list of the builin configurations for the different target
|
The builtin configurations are part of the linker source. They are also
|
||||||
types:
|
distributed together with the machine specific binary packages (usually in the
|
||||||
|
doc directory) and don't have a special format. So if you need a special
|
||||||
<descrip>
|
configuration, it's a good idea to start with the builtin configuration for
|
||||||
<tag><tt>none</tt></tag>
|
your system. In a first step, just replace <tt/-t target/ by <tt/-C
|
||||||
<tscreen><verb>
|
configfile/. The go on and modify the config file to suit your needs.
|
||||||
MEMORY {
|
|
||||||
RAM: start = %S, size = $10000, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = rw;
|
|
||||||
RODATA: load = RAM, type = rw;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>atari</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $82, size = $7E, type = rw;
|
|
||||||
HEADER: start = $0000, size = $6, file = %O;
|
|
||||||
RAM: start = $1F00, size = $9D1F, file = %O; # $9D1F: matches upper bound $BC1F
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
EXEHDR: load = HEADER, type = wprot;
|
|
||||||
CODE: load = RAM, type = wprot, define = yes;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
AUTOSTRT: load = RAM, type = wprot;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>atmos</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw, define = yes;
|
|
||||||
RAM: start = $0600, size = $9200, define = yes, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>c16</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $0fff, size = $7001, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>c64</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $7FF, size = $c801, define = yes, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>c128</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $1bff, size = $a401, define = yes, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = 2,
|
|
||||||
label = __IRQFUNC_TABLE__,
|
|
||||||
count = __IRQFUNC_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>plus4</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $0fff, size = $7001, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>cbm510</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $0001, size = $F3FF, file = %O;
|
|
||||||
VIDRAM: start = $F400, size = $0400, define = yes, file = "";
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = 2,
|
|
||||||
label = __IRQFUNC_TABLE__,
|
|
||||||
count = __IRQFUNC_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $781; # ~2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>cbm610</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $0001, size = $FFF0, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>pet</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $02, size = $1A, type = rw;
|
|
||||||
RAM: start = $03FF, size = $7BFF, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = wprot;
|
|
||||||
RODATA: load = RAM, type = wprot;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>apple2</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
ZP: start = $00, size = $1A, type = rw;
|
|
||||||
RAM: start = $800, size = $8E00, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
CODE: load = RAM, type = ro;
|
|
||||||
RODATA: load = RAM, type = ro;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
<tag><tt>geos</tt></tag>
|
|
||||||
<tscreen><verb>
|
|
||||||
MEMORY {
|
|
||||||
HEADER: start = $204, size = 508, file = %O;
|
|
||||||
RAM: start = $400, size = $5C00, file = %O;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
HEADER: load = HEADER, type = ro;
|
|
||||||
CODE: load = RAM, type = ro;
|
|
||||||
RODATA: load = RAM, type = ro;
|
|
||||||
DATA: load = RAM, type = rw;
|
|
||||||
BSS: load = RAM, type = bss, define = yes;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__;
|
|
||||||
CONDES: segment = RODATA,
|
|
||||||
type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__STACKSIZE__ = $800; # 2K stack
|
|
||||||
}
|
|
||||||
</verb></tscreen>
|
|
||||||
|
|
||||||
</descrip>
|
|
||||||
|
|
||||||
The "<tt/start/" attribute for the <tt/RAM/ memory area of the CBM systems is
|
|
||||||
two less than the actual start of the basic RAM to account for the two bytes
|
|
||||||
load address that is needed on disk and supplied by the startup code.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user