6502/cc65
1
0
Fork 0
mirror of https://github.com/cc65/cc65.git synced 2024-12-27 15:29:46 +00:00
Code Issues Projects Releases Wiki Activity

New special condes type interruptor

Browse Source 
git-svn-id: svn://svn.cc65.org/cc65/trunk@3190 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
cuz 2004-09-20 10:42:29 +00:00
parent cfef8e1e0d
commit f1617b3837
1 changed files with 69 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

103
doc/ca65.sgml
View File

@ -1755,9 +1755,11 @@ Here's a list of all control commands and a description, what they do:
<tt/.CONDES/ is followed by the type, which may be <tt/constructor/, <tt/.CONDES/ is followed by the type, which may be <tt/constructor/,
<tt/destructor/ or a numeric value between 0 and 6 (where 0 is the same as <tt/destructor/ or a numeric value between 0 and 6 (where 0 is the same as
specifiying <tt/constructor/ and 1 is equal to specifying <tt/destructor/). specifiying <tt/constructor/ and 1 is equal to specifying <tt/destructor/).
The <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt> and <tt><ref The <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt>, <tt><ref
id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> commands are actually shortcuts id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> and <tt><ref id=".INTERRUPTOR"
for <tt/.CONDES/ with a type of <tt/constructor/ resp. <tt/destructor/. name=".INTERRUPTORCONSTRUCTOR"></tt>commands are actually shortcuts
for <tt/.CONDES/ with a type of <tt/constructor/ resp. <tt/destructor/ or
<tt/interruptor/.
After the type, an optional priority may be specified. Higher numeric values After the type, an optional priority may be specified. Higher numeric values
mean higher priority. If no priority is given, the default priority of 7 is mean higher priority. If no priority is given, the default priority of 7 is
@ -1771,10 +1773,11 @@ Here's a list of all control commands and a description, what they do:
.condes ModInit, 0, 16 .condes ModInit, 0, 16
</verb></tscreen> </verb></tscreen>
See the <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt> and <tt><ref See the <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt>, <tt><ref
id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> commands and the separate section id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> and <tt><ref id=".INTERRUPTOR"
<ref id="condes" name="Module constructors/destructors"> explaining the name=".INTERRUPTOR"></tt>commands and the separate section <ref id="condes"
feature in more detail. name="Module constructors/destructors"> explaining the feature in more
detail.
<sect1><tt>.CONSTRUCTOR</tt><label id=".CONSTRUCTOR"><p> <sect1><tt>.CONSTRUCTOR</tt><label id=".CONSTRUCTOR"><p>
@ -2531,6 +2534,36 @@ Here's a list of all control commands and a description, what they do:
</verb></tscreen> </verb></tscreen>
<sect1><tt>.INTERRUPTOR</tt><label id=".INTERRUPTOR"><p>
Export a symbol and mark it as an interruptor. This may be used together
with the linker to build a table of interruptor subroutines that are called
in an interrupt.
Note: The linker has a feature to build a table of marked routines, but it
is your code that must call these routines, so just declaring a symbol as
interruptor does nothing by itself.
An interruptor is always exported as an absolute (16 bit) symbol. You don't
need to use an additional <tt/.export/ statement, this is implied by
<tt/.interruptor/. It may have an optional priority that is separated by a
comma. Higher numeric values mean a higher priority. If no priority is
given, the default priority of 7 is used. Be careful when assigning
priorities to your own module constructors so they won't interfere with the
ones in the cc65 library.
Example:
<tscreen><verb>
.interruptor IrqHandler
.interruptor Handler, 16
</verb></tscreen>
See the <tt><ref id=".CONDES" name=".CONDES"></tt> command and the separate
section <ref id="condes" name="Module constructors/destructors"> explaining
the feature in more detail.
<sect1><tt>.LINECONT</tt><label id=".LINECONT"><p> <sect1><tt>.LINECONT</tt><label id=".LINECONT"><p>
Switch on or off line continuations using the backslash character Switch on or off line continuations using the backslash character
@ -3713,14 +3746,16 @@ below uses examples from the C libraries. However, the feature may also be
useful for assembler programs. useful for assembler programs.
<sect1>Module overview<p> <sect1>Overview<p>
Using the <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt> and <tt><ref Using the <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt>, <tt><ref
id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> keywords it it possible to export id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> and <tt><ref id=".INTERRUPTOR"
functions in a special way. The linker is able to generate tables with all name=".INTERRUPTOR"></tt>keywords it it possible to export functions in a
functions of a specific type. Such a table will <em>only</em> include symbols special way. The linker is able to generate tables with all functions of a
from object files that are linked into a specific executable. This may be used specific type. Such a table will <em>only</em> include symbols from object
to add initialization and cleanup code for library modules. files that are linked into a specific executable. This may be used to add
initialization and cleanup code for library modules, or a table of interrupt
handler functions.
The C heap functions are an example where module initialization code is used. The C heap functions are an example where module initialization code is used.
All heap functions (<tt>malloc</tt>, <tt>free</tt>, ...) work with a few All heap functions (<tt>malloc</tt>, <tt>free</tt>, ...) work with a few
@ -3761,36 +3796,35 @@ two bytes in the table (a pointer to the function).
<sect1>Calling order<p> <sect1>Calling order<p>
Both, constructors and destructors are sorted in increasing priority order by The symbols are sorted in increasing priority order by the linker when using
the linker when using one of the builtin linker configurations, so the one of the builtin linker configurations, so the functions with lower
functions with lower priorities come first and are followed by those with priorities come first and are followed by those with higher priorities. The C
higher priorities. The C library runtime subroutine that walks over the library runtime subroutine that walks over the function tables calls the
constructor and destructor tables calls the functions starting from the top of functions starting from the top of the table - which means that functions with
the table - which means that functions with a high priority are called first. a high priority are called first.
So when using the C runtime, both constructors and destructors are called with So when using the C runtime, functions are called with high priority functions
high priority functions first, followed by low priority functions. first, followed by low priority functions.
<sect1>Pitfalls<p> <sect1>Pitfalls<p>
When creating and using module constructors and destructors, please take care When using these special symbols, please take care of the following:
of the following:
<itemize> <itemize>
<item> <item>
The linker will only generate function tables, it will not generate code to The linker will only generate function tables, it will not generate code to
call these functions. If you're using the feature in some other than the call these functions. If you're using the feature in some other than the
existing C environments, you have to write code to call all functions in a existing C environments, you have to write code to call all functions in a
linker generated table yourself. See the <tt>condes</tt> module in the C linker generated table yourself. See the <tt>/condes/ and <tt/callirq/ modules
runtime for an example on how to do this. in the C runtime for an example on how to do this.
<item> <item>
The linker will only add addresses of functions that are in modules linked to The linker will only add addresses of functions that are in modules linked to
the executable. This means that you have to be careful where to place the the executable. This means that you have to be careful where to place the
condes functions. If initialization is needed for a group of functions, be condes functions. If initialization or an irq handler is needed for a group of
sure to place the initialization function into a module that is linked in functions, be sure to place the function into a module that is linked in
regardless of which function is called by the user. regardless of which function is called by the user.
<item> <item>
@ -3805,11 +3839,12 @@ does depend on other initialization or cleanup code, you have to choose the
priority for the functions accordingly. priority for the functions accordingly.
<item> <item>
Besides the <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt> and <tt><ref Besides the <tt><ref id=".CONSTRUCTOR" name=".CONSTRUCTOR"></tt>, <tt><ref
id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> statements, there is also a more id=".DESTRUCTOR" name=".DESTRUCTOR"></tt> and <tt><ref id=".INTERRUPTOR"
generic command: <tt><ref id=".CONDES" name=".CONDES"></tt>. This allows to name=".INTERRUPTOR"></tt>statements, there is also a more generic command:
specify an additional type. Predefined types are 0 (constructor) and 1 <tt><ref id=".CONDES" name=".CONDES"></tt>. This allows to specify an
(destructor). The linker generates a separate table for each type on request. additional type. Predefined types are 0 (constructor), 1 (destructor) and 2
(interruptor). The linker generates a separate table for each type on request.
</itemize> </itemize>