From: cuz Date: Thu, 8 Sep 2005 21:14:40 +0000 (+0000) Subject: Added chapter describing special segments X-Git-Tag: V2.12.0~217 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=3787a13f621790e3accd092fcc2e7d50e795fe2b;p=cc65 Added chapter describing special segments git-svn-id: svn://svn.cc65.org/cc65/trunk@3629 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- diff --git a/doc/ld65.sgml b/doc/ld65.sgml index 41444f06b..195b9b7cc 100644 --- a/doc/ld65.sgml +++ b/doc/ld65.sgml @@ -940,6 +940,37 @@ configfile/. The go on and modify the config file to suit your needs. +Special segments

+ +The builtin config files do contain segments that have a special meaning for +the compiler and the libraries that come with it. If you replace the builtin +config files, you will need the following information. + +INIT

+ +The INIT segment is used for initialization code that may be reused once +executation reaches main() - provided that the program runs in RAM. You +may for example add the INIT segment to the heap in really memory +constrained systems. + +LOWCODE

+ +For the LOWCODE segment, it is guaranteed that it won't be banked out, so it +is reachable at any time by interrupt handlers or similar. + +STARTUP

+ +This segment contains the startup code which initializes the C software stack +and the libraries. It is placed in its own segment because it needs to be +loaded at the lowest possible program address on several platforms. + +HEAP

+ +This segment defines the location of the memory heap used by the malloc +routine. + + + Bugs/Feedback

If you have problems using the linker, if you find any bugs, or if you're