Mercurial > hg > index.cgi
annotate docs/manual/manual.html @ 577:e49d24f4a9a5
Correct bug in the object file output code leading to stack corruption
It turns out leaving a pointer to a stack allocated temporary in a
persistent data structure is not conducive to correct program operation.
Undo the export check setup in the object file output sequence so a
pointer to stack allocated memory is not left hanging when the function
returns. This seems to correct at least one mysterious crash bug, and
possibly others.
Thanks to Boisy Pitre for reporting the crash bug that led to this
discovery, as well as a previous crash bug that likely has the same
root cause.
Additional thanks to Ciaran Anscomb whose debugger wielding wizardry
revealed the exact location of this particular bit of unbrilliance.
author | William Astle <lost@l-w.ca> |
---|---|
date | Sat, 03 Aug 2024 14:30:06 -0600 |
parents | fc072f6cde09 |
children |
rev | line source |
---|---|
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2 <HTML |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3 ><HEAD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
4 ><TITLE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
5 >LW Tool Chain</TITLE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
6 ><META |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
7 NAME="GENERATOR" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
9 ><BODY |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
10 CLASS="BOOK" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
11 BGCOLOR="#FFFFFF" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
12 TEXT="#000000" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
13 LINK="#0000FF" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
14 VLINK="#840084" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
15 ALINK="#0000FF" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
16 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
17 CLASS="BOOK" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
18 ><A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
19 NAME="AEN1" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
20 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
21 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
22 CLASS="TITLEPAGE" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
23 ><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
24 CLASS="TITLE" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
25 ><A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
26 NAME="AEN2" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
27 >LW Tool Chain</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
28 ></H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
29 ><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
30 CLASS="AUTHOR" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
31 ><A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
32 NAME="AEN4" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
33 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
34 >William Astle</H3 |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
35 ><H3 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
36 CLASS="AUTHOR" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
37 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
38 NAME="AEN7" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
39 ></A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
40 >LWTools Contributors </H3 |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
41 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
42 CLASS="COPYRIGHT" |
518
b530ff19f7c0
Update copyright years for manual
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
43 >Copyright © 2009-2021 William Astle and LWTools contributors</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
44 ><HR></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
45 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
46 CLASS="TOC" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
47 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
48 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
49 ><B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
50 >Table of Contents</B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
51 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
52 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
53 >1. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
54 HREF="#AEN13" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
55 >Introduction</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
56 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
57 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
58 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
59 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
60 >1.1. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
61 HREF="#AEN16" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
62 >History</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
63 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
64 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
65 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
66 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
67 >2. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
68 HREF="#AEN21" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
69 >Output Formats</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
70 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
71 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
72 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
73 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
74 >2.1. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
75 HREF="#AEN24" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
76 >Raw Binaries</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
77 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
78 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
79 >2.2. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
80 HREF="#AEN27" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
81 >DECB Binaries</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
82 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
83 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
84 >2.3. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
85 HREF="#AEN32" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
86 >ASCII Hexadecimal</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
87 ></DT |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
88 ><DT |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
89 >2.4. <A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
90 HREF="#AEN36" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
91 >Motorola S-Record</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
92 ></DT |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
93 ><DT |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
94 >2.5. <A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
95 HREF="#AEN41" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
96 >Intel Hex</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
97 ></DT |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
98 ><DT |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
99 >2.6. <A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
100 HREF="#AEN46" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
101 >OS9 Modules</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
102 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
103 ><DT |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
104 >2.7. <A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
105 HREF="#AEN54" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
106 >Object Files</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
107 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
108 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
109 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
110 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
111 >3. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
112 HREF="#AEN62" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
113 >LWASM</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
114 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
115 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
116 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
117 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
118 >3.1. <A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
119 HREF="#AEN65" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
120 >Command Line Options</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
121 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
122 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
123 >3.2. <A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
124 HREF="#AEN229" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
125 >Dialects</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
126 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
127 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
128 >3.3. <A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
129 HREF="#AEN238" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
130 >Source Format</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
131 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
132 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
133 >3.4. <A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
134 HREF="#AEN248" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
135 >Symbols</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
136 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
137 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
138 >3.5. <A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
139 HREF="#AEN253" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
140 >Numbers and Expressions</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
141 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
142 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
143 >3.6. <A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
144 HREF="#AEN261" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
145 >Assembler Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
146 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
147 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
148 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
149 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
150 >3.6.1. <A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
151 HREF="#AEN264" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
152 >Data Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
153 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
154 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
155 >3.6.2. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
156 HREF="#AEN381" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
157 >Address Definition</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
158 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
159 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
160 >3.6.3. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
161 HREF="#AEN432" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
162 >Conditional Assembly</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
163 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
164 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
165 >3.6.4. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
166 HREF="#AEN503" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
167 >OS9 Target Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
168 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
169 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
170 >3.6.5. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
171 HREF="#AEN528" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
172 >Miscelaneous Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
173 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
174 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
175 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
176 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
177 >3.7. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
178 HREF="#AEN568" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
179 >Macros</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
180 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
181 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
182 >3.8. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
183 HREF="#AEN591" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
184 >Structures</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
185 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
186 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
187 >3.9. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
188 HREF="#AEN612" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
189 >Object Files and Sections</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
190 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
191 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
192 >3.10. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
193 HREF="#AEN676" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
194 >Assembler Modes and Pragmas</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
195 ></DT |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
196 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
197 >3.11. <A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
198 HREF="#CONVINST" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
199 >Convenience Instructions</A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
200 ></DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
201 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
202 >3.12. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
203 HREF="#AEN832" |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
204 >Cycle Counts</A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
205 ></DT |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
206 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
207 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
208 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
209 >4. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
210 HREF="#AEN838" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
211 >LWLINK</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
212 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
213 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
214 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
215 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
216 >4.1. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
217 HREF="#AEN841" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
218 >Command Line Options</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
219 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
220 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
221 >4.2. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
222 HREF="#AEN938" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
223 >Linker Operation</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
224 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
225 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
226 >4.3. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
227 HREF="#AEN952" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
228 >Linking Scripts</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
229 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
230 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
231 >4.4. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
232 HREF="#AEN1019" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
233 >Format Specific Linking Notes</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
234 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
235 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
236 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
237 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
238 >4.4.1. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
239 HREF="#AEN1022" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
240 >OS9 Modules</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
241 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
242 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
243 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
244 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
245 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
246 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
247 >5. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
248 HREF="#AEN1034" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
249 >Libraries and LWAR</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
250 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
251 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
252 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
253 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
254 >5.1. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
255 HREF="#AEN1038" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
256 >Command Line Options</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
257 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
258 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
259 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
260 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
261 >6. <A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
262 HREF="#OBJCHAP" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
263 >Object Files</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
264 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
265 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
266 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
267 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
268 CLASS="LOT" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
269 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
270 CLASS="LOT" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
271 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
272 ><B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
273 >List of Tables</B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
274 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
275 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
276 >6-1. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
277 HREF="#AEN1121" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
278 >Object File Term Types</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
279 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
280 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
281 >6-2. <A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
282 HREF="#AEN1151" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
283 >Object File Operator Numbers</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
284 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
285 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
286 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
287 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
288 CLASS="CHAPTER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
289 ><HR><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
290 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
291 NAME="AEN13" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
292 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
293 >Chapter 1. Introduction</H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
294 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
295 >The LW tool chain provides utilities for building binaries for MC6809 and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
296 HD6309 CPUs. The tool chain includes a cross-assembler and a cross-linker |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
297 which support several styles of output.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
298 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
299 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
300 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
301 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
302 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
303 NAME="AEN16" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
304 >1.1. History</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
305 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
306 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
307 >For a long time, I have had an interest in creating an operating system for |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
308 the Coco3. I finally started working on that project around the beginning of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
309 2006. I had a number of assemblers I could choose from. Eventually, I settled |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
310 on one and started tinkering. After a while, I realized that assembler was not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
311 going to be sufficient due to lack of macros and issues with forward references. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
312 Then I tried another which handled forward references correctly but still did |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
313 not support macros. I looked around at other assemblers and they all lacked |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
314 one feature or another that I really wanted for creating my operating system.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
315 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
316 >The solution seemed clear at that point. I am a fair programmer so I figured |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
317 I could write an assembler that would do everything I wanted an assembler to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
318 do. Thus the LWASM probject was born. After more than two years of on and off |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
319 work, version 1.0 of LWASM was released in October of 2008.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
320 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
321 >As the aforementioned operating system project progressed further, it became |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
322 clear that while assembling the whole project through a single file was doable, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
323 it was not practical. When I found myself playing some fancy games with macros |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
324 in a bid to simulate sections, I realized I needed a means of assembling |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
325 source files separately and linking them later. This spawned a major development |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
326 effort to add an object file support to LWASM. It also spawned the LWLINK |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
327 project to provide a means to actually link the files.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
328 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
329 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
330 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
331 CLASS="CHAPTER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
332 ><HR><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
333 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
334 NAME="AEN21" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
335 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
336 >Chapter 2. Output Formats</H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
337 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
338 >The LW tool chain supports multiple output formats. Each format has its |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
339 advantages and disadvantages. Each format is described below.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
340 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
341 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
342 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
343 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
344 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
345 NAME="AEN24" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
346 >2.1. Raw Binaries</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
347 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
348 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
349 >A raw binary is simply a string of bytes. There are no headers or other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
350 niceties. Both LWLINK and LWASM support generating raw binaries. ORG directives |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
351 in the source code only serve to set the addresses that will be used for |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
352 symbols but otherwise have no direct impact on the resulting binary.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
353 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
354 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
355 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
356 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
357 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
358 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
359 NAME="AEN27" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
360 >2.2. DECB Binaries</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
361 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
362 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
363 >A DECB binary is compatible with the LOADM command in Disk Extended |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
364 Color Basic on the CoCo. They are also compatible with CLOADM from Extended |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
365 Color Basic. These binaries include the load address of the binary as well |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
366 as encoding an execution address. These binaries may contain multiple loadable |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
367 sections, each of which has its own load address.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
368 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
369 >Each binary starts with a preamble. Each preamble is five bytes long. The |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
370 first byte is zero. The next two bytes specify the number of bytes to load |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
371 and the last two bytes specify the address to load the bytes at. Then, a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
372 string of bytes follows. After this string of bytes, there may be another |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
373 preamble or a postamble. A postamble is also five bytes in length. The first |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
374 byte of the postamble is $FF, the next two are zero, and the last two are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
375 the execution address for the binary.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
376 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
377 >Both LWASM and LWLINK can output this format.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
378 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
379 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
380 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
381 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
382 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
383 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
384 NAME="AEN32" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
385 >2.3. ASCII Hexadecimal</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
386 ></H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
387 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
388 >This human-readable ASCII hexadecimal format consists of CR+LF terminated |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
389 lines of ASCII text. Each line has the following structure: a zero-padded |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
390 four-digit ASCII hex address, a colon separator, and one or more zero-padded |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
391 two-digit hex values separated by commas. ASCII Hexadecimal format favors |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
392 paragraph-aligned addresses (i.e. a least significant address nybble value |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
393 of zero). During output, the number of hex values on each line are adjusted |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
394 to align the address of the next line on a paragraph boundary. The sequence |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
395 of addresses in the ASCII Hexadecimal file directly follows that of the source |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
396 file; multiple ORG directives in the source code may result in out-of-sequence |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
397 addresses in the ASCII Hexadecimal output.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
398 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
399 >LWASM can output this format since version 4.10.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
400 ></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
401 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
402 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
403 ><HR><H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
404 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
405 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
406 NAME="AEN36" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
407 >2.4. Motorola S-Record</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
408 ></H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
409 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
410 >This ASCII format consists of a series of CR+LF terminated "records" of ASCII |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
411 text. Each record has the following structure: a start-of-record character |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
412 "S", an ASCII record type digit (0-9), a two-digit ASCII hex byte count, a |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
413 four-digit ASCII hex address, an optional sequence of two-digit ASCII hex data |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
414 values, and a two-digit ASCII hex checksum. The LW tool chain issues only S0, |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
415 S1, S5 and S9 record types. S1 records are limited to maximum of 16 data bytes |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
416 in length, and paragraph alignment of addresses is favored. The address |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
417 sequence of the S-Records directly follows that of the source file; multiple |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
418 ORG directives in the source code may result in out-of-sequence addresses in |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
419 the S-Record output. </P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
420 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
421 >Motorola S-Record format is a standard ASCII format accepted by most memory |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
422 device programming equipment. It is particularly useful when the assembled |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
423 code output is destined to reside within an EPROM or Flash memory device, |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
424 for example.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
425 ><P |
345
e95f07cbce4e
Update manual to reflect lwlink support for S-record output
William Astle <lost@l-w.ca>
parents:
333
diff
changeset
|
426 >LWASM can output this format since version 4.10. LWLINK can output this format |
e95f07cbce4e
Update manual to reflect lwlink support for S-record output
William Astle <lost@l-w.ca>
parents:
333
diff
changeset
|
427 since version 4.11.</P |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
428 ></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
429 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
430 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
431 ><HR><H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
432 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
433 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
434 NAME="AEN41" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
435 >2.5. Intel Hex</A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
436 ></H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
437 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
438 >This ASCII format consists of a series of CR+LF terminated "records" of ASCII |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
439 text. Each record has the following structure: a start-of-record character |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
440 ":", a two-digit ASCII hex byte count, a four-digit ASCII hex address, a two- |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
441 digit ASCII hex record type, an optional sequence of two-digit ASCII hex data |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
442 values, and a two-digit ASCII hex checksum. The LW tool chain issues only 00, |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
443 and 01 Intel Hex record types. Data records are limited to maximum of 16 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
444 data bytes in length, and paragraph alignment of addresses is favored. The |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
445 address sequence of the Intel hex records directly follows that of the source |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
446 file; multiple ORG directives in the source code may result in out-of-sequence |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
447 addresses in the Intel Hex output. </P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
448 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
449 >Intel Hex format is the other standard ASCII format accepted by most memory |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
450 device programming equipment, it and the Motorola S-Record format are used for |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
451 similar purposes.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
452 ><P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
453 >LWASM can output this format since version 4.10.</P |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
454 ></DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
455 ><DIV |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
456 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
457 ><HR><H2 |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
458 CLASS="SECTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
459 ><A |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
460 NAME="AEN46" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
461 >2.6. OS9 Modules</A |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
462 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
463 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
464 > Since version 2.5, LWASM is able to generate OS9 modules. The syntax is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
465 basically the same as for other assemblers. A module starts with the MOD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
466 directive and ends with the EMOD directive. The OS9 directive is provided |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
467 as a shortcut for writing system calls. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
468 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
469 > LWASM does NOT provide an OS9Defs file. You must provide your own. Also note |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
470 that the common practice of using "ifp1" around the inclusion of the OS9Defs |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
471 file is discouraged as it is pointless and can lead to unintentional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
472 problems and phasing errors. Because LWASM reads each file exactly once, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
473 there is no benefit to restricting the inclusion to the first assembly pass. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
474 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
475 > As of version 4.5, LWASM also implements the standard data/code address |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
476 streams for OS9 modules. That means that between MOD and EMOD, any RMB, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
477 RMD, RMQ, or equivalent directives will move the data address ahead and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
478 leave the code address unmodified. Outside of an actual module, both the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
479 code and data addresses are moved ahead equally. That last bit is critical |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
480 to understand because it means any directives that follow an EMOD directive |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
481 may have different results than other assemblers. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
482 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
483 > Additionally, within a module body, the ORG directive sets only the data |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
484 address, not the code address. However, outside a module body, ORG sets both |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
485 addresses. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
486 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
487 >Both code and data addresses are reset to 0 by the MOD directive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
488 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
489 > As of version 4.5, LWLINK also supports creation of OS9 modules. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
490 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
491 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
492 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
493 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
494 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
495 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
496 NAME="AEN54" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
497 >2.7. Object Files</A |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
498 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
499 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
500 >LWASM supports generating a proprietary object file format which is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
501 described in <A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
502 HREF="#OBJCHAP" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
503 >Chapter 6</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
504 >. LWLINK is then used to link these |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
505 object files into a final binary in any of LWLINK's supported binary |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
506 formats.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
507 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
508 >Object files also support the concept of sections which are not valid |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
509 for other output types. This allows related code from each object file |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
510 linked to be collapsed together in the final binary.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
511 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
512 >Object files are very flexible in that they allow references that are not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
513 known at assembly time to be resolved at link time. However, because the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
514 addresses of such references are not known at assembly time, there is no way |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
515 for the assembler to deduce that an eight bit addressing mode is possible. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
516 That means the assember will default to using sixteen bit addressing |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
517 whenever an external or cross-section reference is used.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
518 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
519 >As of LWASM 2.4, it is possible to force direct page addressing for an |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
520 external reference. Care must be taken to ensure the resulting addresses |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
521 are really in the direct page since the linker does not know what the direct |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
522 page is supposed to be and does not emit errors for byte overflows.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
523 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
524 >It is also possible to use external references in an eight bit immediate |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
525 mode instruction. In this case, only the low order eight bits will be used. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
526 Again, no byte overflows will be flagged.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
527 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
528 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
529 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
530 CLASS="CHAPTER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
531 ><HR><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
532 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
533 NAME="AEN62" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
534 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
535 >Chapter 3. LWASM</H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
536 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
537 >The LWTOOLS assembler is called LWASM. This chapter documents the various |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
538 features of the assembler. It is not, however, a tutorial on 6x09 assembly |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
539 language programming.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
540 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
541 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
542 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
543 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
544 ><A |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
545 NAME="AEN65" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
546 >3.1. Command Line Options</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
547 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
548 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
549 >The binary for LWASM is called "lwasm". Note that the binary is in lower |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
550 case. lwasm takes the following command line arguments.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
551 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
552 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
553 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
554 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
555 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
556 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
557 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
558 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
559 >--6309</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
560 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
561 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
562 >-3</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
563 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
564 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
565 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
566 >This will cause the assembler to accept the additional instructions available |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
567 on the 6309 processor. This is the default mode; this option is provided for |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
568 completeness and to override preset command arguments.</P |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
569 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
570 >This option is the same as if the first line of the source code is "PRAGMA 6309".</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
571 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
572 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
573 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
574 CLASS="OPTION" |
333
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
575 >--6800compat</CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
576 ></DT |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
577 ><DD |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
578 ><P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
579 >This is equivalent to <CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
580 CLASS="OPTION" |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
581 >--pragma=6800compat</CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
582 >.</P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
583 ><P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
584 >This will enable recognition of 6800 compatibility instructions.</P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
585 ></DD |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
586 ><DT |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
587 ><CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
588 CLASS="OPTION" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
589 >--6809</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
590 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
591 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
592 >-9</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
593 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
594 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
595 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
596 >This will cause the assembler to reject instructions that are only available |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
597 on the 6309 processor. This actually has the effect of starting the assembler |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
598 as though the first line of the source is "PRAGMA 6809".</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
599 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
600 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
601 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
602 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
603 >--decb</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
604 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
605 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
606 >-b</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
607 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
608 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
609 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
610 >Select the DECB output format target. Equivalent to <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
611 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
612 >--format=decb</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
613 >.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
614 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
615 >While this is the default output format currently, it is not safe to rely |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
616 on that fact. Future versions may have different defaults. It is also trivial |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
617 to modify the source code to change the default. Thus, it is recommended to specify |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
618 this option if you need DECB output.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
619 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
620 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
621 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
622 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
623 >--format=type</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
624 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
625 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
626 >-f type</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
627 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
628 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
629 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
630 >Select the output format. Valid values are <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
631 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
632 >obj</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
633 > for the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
634 object file target, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
635 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
636 >decb</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
637 > for the DECB LOADM format, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
638 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
639 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
640 >os9</CODE |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
641 > for creating OS9 modules, <CODE |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
642 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
643 >raw</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
644 > for |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
645 a raw binary, <CODE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
646 CLASS="OPTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
647 >hex</CODE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
648 > for ASCII hexadecminal format, |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
649 <CODE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
650 CLASS="OPTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
651 >srec</CODE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
652 > for Motorola S-Record format, and <CODE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
653 CLASS="OPTION" |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
654 >ihex</CODE |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
655 > |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
656 for Intel Hex format.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
657 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
658 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
659 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
660 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
661 >--list[=file]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
662 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
663 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
664 >-l[file]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
665 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
666 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
667 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
668 >Cause LWASM to generate a listing. If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
669 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
670 >file</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
671 > is specified, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
672 the listing will go to that file. Otherwise it will go to the standard output |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
673 stream. By default, no listing is generated. Unless <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
674 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
675 >--symbols</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
676 > |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
677 is specified, the list will not include the symbol table.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
678 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
679 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
680 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
681 CLASS="OPTION" |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
682 >--symbol-dump[=file]</CODE |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
683 ></DT |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
684 ><DD |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
685 ><P |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
686 >Cause LWASM to output the global symbol table in assembly source format. If |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
687 <CODE |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
688 CLASS="OPTION" |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
689 >file</CODE |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
690 > is specified, the table output will go to the specified |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
691 file. Otherwise, it will go to the standard output stream. Local symbols will |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
692 not be included. Incomplete symbols will be defined to zero with a comment |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
693 indicating incompleteness. Symbols defined with SET will also be listed using |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
694 SET in the symbol dump. However, if the symbol is defined multiple times, the |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
695 order of the definitions in the dump file is undefined.</P |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
696 ></DD |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
697 ><DT |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
698 ><CODE |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
699 CLASS="OPTION" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
700 >--symbols</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
701 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
702 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
703 >-s</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
704 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
705 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
706 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
707 >Causes LWASM to generate a list of symbols when generating a listing. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
708 It has no effect unless a listing is being generated.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
709 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
710 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
711 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
712 CLASS="OPTION" |
369
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
713 >--symbols-nolocals</CODE |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
714 ></DT |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
715 ><DD |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
716 ><P |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
717 >Behaves just like <CODE |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
718 CLASS="OPTION" |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
719 >--symbols</CODE |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
720 > but with local labels omitted.</P |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
721 ></DD |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
722 ><DT |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
723 ><CODE |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
724 CLASS="OPTION" |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
725 >--map=FILE</CODE |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
726 ></DT |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
727 ><DD |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
728 ><P |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
729 > This option generates a map file which can be used by debuggers and monitors to provide symbol information. A map file may be created independent of a listing file. (Patches are pending for MAME and exec09.) </P |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
730 ></DD |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
731 ><DT |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
732 ><CODE |
682524a1f32f
Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
348
diff
changeset
|
733 CLASS="OPTION" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
734 >--obj</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
735 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
736 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
737 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
738 >Select the proprietary object file format as the output target.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
739 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
740 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
741 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
742 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
743 >--output=FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
744 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
745 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
746 >-o FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
747 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
748 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
749 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
750 >This option specifies the name of the output file. If not specified, the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
751 default is <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
752 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
753 >a.out</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
754 >.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
755 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
756 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
757 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
758 CLASS="OPTION" |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
759 >--no-output</CODE |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
760 ></DT |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
761 ><DD |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
762 ><P |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
763 >Do assembly as usual but suppress generation of the output file.</P |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
764 ></DD |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
765 ><DT |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
766 ><CODE |
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
767 CLASS="OPTION" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
768 >--pragma=pragma</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
769 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
770 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
771 >-p pragma</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
772 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
773 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
774 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
775 >Specify assembler pragmas. Multiple pragmas are separated by commas. The |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
776 pragmas accepted are the same as for the PRAGMA assembler directive described |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
777 below.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
778 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
779 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
780 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
781 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
782 >--raw</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
783 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
784 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
785 >-r</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
786 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
787 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
788 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
789 >Select raw binary as the output target.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
790 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
791 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
792 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
793 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
794 >--includedir=path</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
795 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
796 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
797 >-I path</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
798 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
799 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
800 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
801 >Add <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
802 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
803 >path</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
804 > to the end of the include path.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
805 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
806 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
807 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
808 CLASS="OPTION" |
231
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
809 >--define=SYM[=VAL]</CODE |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
810 >, <CODE |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
811 CLASS="OPTION" |
245
0bc1c88fe776
Fix typo in documentation of lwasm --define switch.
William Astle <lost@l-w.ca>
parents:
236
diff
changeset
|
812 >-D SYM[=VAL]</CODE |
231
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
813 ></DT |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
814 ><DD |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
815 ><P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
816 >Pre-defines the symbol SYM as either the specified VAL. If VAL is omitted, |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
817 the symbol is defined as 1. The symbol will be defined as though it were |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
818 defined using the SET directive in the assembly source. That means it can |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
819 be overridden by a SET directive within the source code. Attempting to |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
820 redefine SYM using EQU will result in a multiply defined symbol error.</P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
821 ></DD |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
822 ><DT |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
823 ><CODE |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
824 CLASS="OPTION" |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
825 >-t WIDTH</CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
826 >, <CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
827 CLASS="OPTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
828 >--tabs=WIDTH</CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
829 ></DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
830 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
831 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
832 >Specifies the handling of tabs in listing files. <CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
833 CLASS="OPTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
834 >--tabs=0</CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
835 > |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
836 disables tab expansion. <CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
837 CLASS="OPTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
838 >--tabs=8</CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
839 > is the default setting.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
840 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
841 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
842 ><CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
843 CLASS="OPTION" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
844 >--help</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
845 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
846 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
847 >-?</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
848 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
849 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
850 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
851 >Present a help screen describing the command line options.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
852 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
853 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
854 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
855 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
856 >--usage</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
857 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
858 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
859 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
860 >Provide a summary of the command line options.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
861 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
862 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
863 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
864 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
865 >--version</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
866 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
867 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
868 >-V</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
869 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
870 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
871 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
872 >Display the software version.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
873 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
874 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
875 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
876 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
877 >--debug</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
878 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
879 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
880 >-d</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
881 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
882 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
883 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
884 >Increase the debugging level. Only really useful to people hacking on the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
885 LWASM source code itself.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
886 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
887 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
888 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
889 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
890 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
891 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
892 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
893 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
894 ><A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
895 NAME="AEN229" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
896 >3.2. Dialects</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
897 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
898 ><P |
333
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
899 > LWASM supports all documented MC6809 instructions as defined by |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
900 Motorola. By default, this does not include any MC6800 compatibility |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
901 instructions. As of LWASM 4.11, those compatibility instructions can be |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
902 enabled using the <CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
903 CLASS="PARAMETER" |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
904 >--6800compat</CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
905 > option or the |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
906 <CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
907 CLASS="PARAMETER" |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
908 >6800compat</CODE |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
909 > pragma. It also supports all known HD6309 |
563
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
910 instructions. While there is general agreement on the mnemonics for most |
333
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
911 of the 6309 instructions, there is some variance with the block transfer |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
912 instructions. TFM for all four variations seems to have gained the most |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
913 traction and, thus, this is the form that is recommended for LWASM. |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
914 However, it also supports COPY, COPY-, IMP, EXP, TFRP, TFRM, TFRS, and TFRR. |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
915 It further adds COPY+ as a synomym for COPY, IMPLODE for IMP, and EXPAND for |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
916 EXP. </P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
917 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
918 >By default, LWASM accepts 6309 instructions. However, using the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
919 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
920 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
921 >--6809</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
922 > parameter, you can cause it to throw errors on |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
923 6309 instructions instead.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
924 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
925 >The standard addressing mode specifiers are supported. These are the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
926 hash sign ("#") for immediate mode, the less than sign ("<") for forced |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
927 eight bit modes, and the greater than sign (">") for forced sixteen bit modes.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
928 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
929 >Additionally, LWASM supports using the asterisk ("*") to indicate |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
930 base page addressing. This should not be used in hand-written source code, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
931 however, because it is non-standard and may or may not be present in future |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
932 versions of LWASM.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
933 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
934 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
935 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
936 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
937 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
938 ><A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
939 NAME="AEN238" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
940 >3.3. Source Format</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
941 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
942 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
943 >LWASM accepts plain text files in a relatively free form. It can handle |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
944 lines terminated with CR, LF, CRLF, or LFCR which means it should be able |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
945 to assemble files on any platform on which it compiles.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
946 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
947 >Each line may start with a symbol. If a symbol is present, there must not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
948 be any whitespace preceding it. It is legal for a line to contain nothing |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
949 but a symbol.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
950 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
951 >The op code is separated from the symbol by whitespace. If there is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
952 no symbol, there must be at least one white space character preceding it. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
953 If applicable, the operand follows separated by whitespace. Following the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
954 opcode and operand is an optional comment.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
955 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
956 > It is important to note that operands cannot contain any whitespace |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
957 except in the case of delimited strings. This is because the first |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
958 whitespace character will be interpreted as the separator between the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
959 operand column and the comment. This behaviour is required for approximate |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
960 source compatibility with other 6x09 assemblers. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
961 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
962 >A comment can also be introduced with a * or a ;. The comment character is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
963 optional for end of statement comments. However, if a symbol is the only |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
964 thing present on the line other than the comment, the comment character is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
965 mandatory to prevent the assembler from interpreting the comment as an opcode.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
966 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
967 >For compatibility with the output generated by some C preprocessors, LWASM |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
968 will also ignore lines that begin with a #. This should not be used as a general |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
969 comment character, however.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
970 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
971 >The opcode is not treated case sensitively. Neither are register names in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
972 the operand fields. Symbols, however, are case sensitive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
973 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
974 > As of version 2.6, LWASM supports files with line numbers. If line |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
975 numbers are present, the line must start with a digit. The line number |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
976 itself must consist only of digits. The line number must then be followed |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
977 by either the end of the line or exactly one white space character. After |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
978 that white space character, the lines are interpreted exactly as above. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
979 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
980 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
981 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
982 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
983 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
984 ><A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
985 NAME="AEN248" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
986 >3.4. Symbols</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
987 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
988 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
989 >Symbols have no length restriction. They may contain letters, numbers, dots, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
990 dollar signs, and underscores. They must start with a letter, dot, or |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
991 underscore.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
992 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
993 >LWASM also supports the concept of a local symbol. A local symbol is one |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
994 which contains either a "?" or a "@", which can appear anywhere in the symbol. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
995 The scope of a local symbol is determined by a number of factors. First, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
996 each included file gets its own local symbol scope. A blank line will also |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
997 be considered a local scope barrier. Macros each have their own local symbol |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
998 scope as well (which has a side effect that you cannot use a local symbol |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
999 as an argument to a macro). There are other factors as well. In general, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1000 a local symbol is restricted to the block of code it is defined within.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1001 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1002 >By default, unless assembling to the os9 target, a "$" in the symbol will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1003 also make it local. This can be controlled by the "dollarlocal" and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1004 "nodollarlocal" pragmas. In the absence of a pragma to the contrary, for |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1005 the os9 target, a "$" in the symbol will not make it considered local while |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1006 for all other targets it will.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1007 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1008 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1009 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1010 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1011 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1012 ><A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
1013 NAME="AEN253" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1014 >3.5. Numbers and Expressions</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1015 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1016 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1017 > Numbers can be expressed in binary, octal, decimal, or hexadecimal. Binary |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1018 numbers may be prefixed with a "%" symbol or suffixed with a "b" or "B". |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1019 Octal numbers may be prefixed with "@" or suffixed with "Q", "q", "O", or |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1020 "o". Hexadecimal numbers may be prefixed with "$", "0x" or "0X", or suffixed |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1021 with "H". No prefix or suffix is required for decimal numbers but they can |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1022 be prefixed with "&" if desired. Any constant which begins with a letter |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1023 must be expressed with the correct prefix base identifier or be prefixed |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1024 with a 0. Thus hexadecimal FF would have to be written either 0FFH or $FF. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1025 Numbers are not case sensitive. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1026 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1027 > A symbol may appear at any point where a number is acceptable. The |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1028 special symbol "*" can be used to represent the starting address of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1029 current source line within expressions. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1030 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1031 >The ASCII value of a character can be included by prefixing it with a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1032 single quote ('). The ASCII values of two characters can be included by |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1033 prefixing the characters with a quote (").</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1034 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1035 > LWASM supports the following basic binary operators: +, -, *, /, and %. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1036 These represent addition, subtraction, multiplication, division, and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1037 modulus. It also supports unary negation and unary 1's complement (- and ^ |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1038 respectively). It is also possible to use ~ for the unary 1's complement |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1039 operator. For completeness, a unary positive (+) is supported though it is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1040 a no-op. LWASM also supports using |, &, and ^ for bitwise or, bitwise and, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1041 and bitwise exclusive or respectively. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1042 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1043 > Operator precedence follows the usual rules. Multiplication, division, and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1044 modulus take precedence over addition and subtraction. Unary operators take |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1045 precedence over binary operators. Bitwise operators are lower precdence |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1046 than addition and subtraction. To force a specific order of evaluation, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1047 parentheses can be used in the usual manner. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1048 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1049 > As of LWASM 2.5, the operators && and || are recognized for boolean and and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1050 boolean or respectively. They will return either 0 or 1 (false or true). |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1051 They have the lowest precedence of all the binary operators. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1052 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1053 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1054 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1055 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1056 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1057 ><A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
1058 NAME="AEN261" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1059 >3.6. Assembler Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1060 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1061 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1062 >Various directives can be used to control the behaviour of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1063 assembler or to include non-code/data in the resulting output. Those directives |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1064 that are not described in detail in other sections of this document are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1065 described below.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1066 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1067 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1068 ><HR><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1069 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1070 ><A |
489
52af0aa54fe5
Update html and pdf documentation in preparation for release
William Astle <lost@l-w.ca>
parents:
478
diff
changeset
|
1071 NAME="AEN264" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1072 >3.6.1. Data Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1073 ></H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1074 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1075 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1076 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1077 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1078 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1079 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1080 >FCB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1081 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1082 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1083 >, .DB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1084 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1085 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1086 >, .BYTE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1087 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1088 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1089 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1090 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1091 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1092 >Include one or more constant bytes (separated by commas) in the output.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1093 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1094 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1095 >FDB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1096 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1097 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1098 >, .DW <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1099 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1100 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1101 >, .WORD <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1102 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1103 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1104 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1105 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1106 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1107 >Include one or more words (separated by commas) in the output.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1108 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1109 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1110 >FQB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1111 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1112 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1113 >, .QUAD <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1114 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1115 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1116 >, .4BYTE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1117 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1118 >expr[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1119 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1120 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1121 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1122 >Include one or more double words (separated by commas) in the output.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1123 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1124 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1125 >FCC <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1126 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1127 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1128 >, .ASCII <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1129 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1130 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1131 >, .STR <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1132 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1133 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1134 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1135 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1136 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1137 >Include a string of text in the output. The first character of the operand |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1138 is the delimiter which must appear as the last character and cannot appear |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1139 within the string. The string is included with no modifications></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1140 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1141 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1142 >FCN <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1143 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1144 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1145 >, .ASCIZ <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1146 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1147 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1148 >, .STRZ <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1149 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1150 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1151 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1152 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1153 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1154 >Include a NUL terminated string of text in the output. The first character of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1155 the operand is the delimiter which must appear as the last character and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1156 cannot appear within the string. A NUL byte is automatically appended to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1157 the string.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1158 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1159 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1160 >FCS <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1161 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1162 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1163 >, .ASCIS <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1164 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1165 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1166 >, .STRS <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1167 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1168 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1169 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1170 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1171 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1172 >Include a string of text in the output with bit 7 of the final byte set. The |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1173 first character of the operand is the delimiter which must appear as the last |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1174 character and cannot appear within the string.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1175 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1176 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1177 >ZMB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1178 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1179 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1180 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1181 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1182 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1183 >Include a number of NUL bytes in the output. The number must be fully resolvable |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1184 during pass 1 of assembly so no forward or external references are permitted.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1185 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1186 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1187 >ZMD <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1188 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1189 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1190 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1191 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1192 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1193 >Include a number of zero words in the output. The number must be fully |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1194 resolvable during pass 1 of assembly so no forward or external references are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1195 permitted.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1196 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1197 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1198 >ZMQ <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1199 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1200 >expr<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1201 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1202 ></CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1203 ></CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1204 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1205 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1206 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1207 >Include a number of zero double-words in the output. The number must be fully |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1208 resolvable during pass 1 of assembly so no forward or external references are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1209 permitted.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1210 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1211 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1212 >RMB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1213 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1214 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1215 >, .BLKB <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1216 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1217 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1218 >, .DS <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1219 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1220 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1221 >, .RS <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1222 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1223 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1224 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1225 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1226 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1227 >Reserve a number of bytes in the output. The number must be fully resolvable |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1228 during pass 1 of assembly so no forward or external references are permitted. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1229 The value of the bytes is undefined.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1230 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1231 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1232 >RMD <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1233 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1234 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1235 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1236 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1237 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1238 >Reserve a number of words in the output. The number must be fully |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1239 resolvable during pass 1 of assembly so no forward or external references are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1240 permitted. The value of the words is undefined.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1241 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1242 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1243 >RMQ <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1244 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1245 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1246 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1247 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1248 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1249 >Reserve a number of double-words in the output. The number must be fully |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1250 resolvable during pass 1 of assembly so no forward or external references are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1251 permitted. The value of the double-words is undefined.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1252 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1253 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1254 >INCLUDEBIN <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1255 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1256 >filename</CODE |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1257 >[,<CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1258 CLASS="PARAMETER" |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1259 >start</CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1260 >[,<CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1261 CLASS="PARAMETER" |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1262 >length</CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1263 >]]</DT |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1264 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1265 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1266 >Treat the contents of <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1267 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1268 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1269 > as a string of bytes to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1270 be included literally at the current assembly point. This has the same effect |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1271 as converting the file contents to a series of FCB statements and including |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1272 those at the current assembly point.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1273 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1274 > If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1275 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1276 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1277 > beings with a /, the file name |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1278 will be taken as absolute. Otherwise, the current directory will be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1279 searched followed by the search path in the order specified.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1280 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1281 > Please note that absolute path detection including drive letters will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1282 not function correctly on Windows platforms. Non-absolute inclusion will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1283 work, however.</P |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1284 ><P |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1285 > The optional <CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1286 CLASS="PARAMETER" |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1287 >start</CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1288 > parameter allows you to set |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1289 the byte offset to start reading from the binary file. Positive values are |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1290 from the beginning of the file, negative values are from the end of the file.</P |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1291 ><P |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1292 > The optional <CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1293 CLASS="PARAMETER" |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1294 >length</CODE |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1295 > parameter allows you to set |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1296 the number of bytes read from the binary file. If missing, then the file is |
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1297 read to the end.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1298 ></DD |
254
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1299 ><DT |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1300 >FILL <CODE |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1301 CLASS="PARAMETER" |
451 | 1302 >byte</CODE |
254
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1303 >,<CODE |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1304 CLASS="PARAMETER" |
451 | 1305 >size</CODE |
254
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1306 ></DT |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1307 ><DD |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1308 ><P |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1309 >Insert <CODE |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1310 CLASS="PARAMETER" |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1311 >size</CODE |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1312 > bytes of <CODE |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1313 CLASS="PARAMETER" |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1314 >byte</CODE |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1315 >.</P |
155799f6cfa5
Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
253
diff
changeset
|
1316 ></DD |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1317 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1318 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1319 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1320 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1321 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1322 ><HR><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1323 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1324 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1325 NAME="AEN381" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1326 >3.6.2. Address Definition</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1327 ></H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1328 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1329 >The directives in this section all control the addresses of symbols |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1330 or the assembly process itself.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1331 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1332 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1333 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1334 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1335 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1336 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1337 >ORG <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1338 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1339 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1340 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1341 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1342 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1343 >Set the assembly address. The address must be fully resolvable on the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1344 first pass so no external or forward references are permitted. ORG is not |
324
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
1345 permitted within sections when outputting to object files. For target formats |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
1346 that include address information (decb, hex, srec, and ihex), an ORG |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
1347 directive will re-start the address sequence within the output. When using |
b30091890d62
Add documentation of the new hex output formats.
William Astle <lost@l-w.ca>
parents:
316
diff
changeset
|
1348 the raw target format, ORG is used only to determine the addresses of symbols.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1349 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1350 ><DT |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1351 >REORG</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1352 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1353 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1354 >Sets the assembly address to the value it had immediately prior to the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1355 previous ORG statement. It is used to continue assembly after some |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1356 specification that required an additional ORG. This directive is primarily |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1357 intended for MACRO-80c compatibility. Consider using alternatives in |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1358 modern code.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1359 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1360 ><DT |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1361 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1362 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1363 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1364 > EQU <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1365 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1366 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1367 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1368 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1369 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1370 > = <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1371 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1372 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1373 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1374 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1375 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1376 >Define the value of <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1377 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1378 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1379 > to be <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1380 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1381 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1382 >.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1383 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1384 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1385 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1386 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1387 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1388 > SET <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1389 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1390 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1391 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1392 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1393 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1394 >Define the value of <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1395 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1396 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1397 > to be <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1398 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1399 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1400 >. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1401 Unlike EQU, SET permits symbols to be defined multiple times as long as SET |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1402 is used for all instances. Use of the symbol before the first SET statement |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1403 that sets its value is undefined.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1404 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1405 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1406 >SETDP <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1407 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1408 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1409 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1410 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1411 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1412 >Inform the assembler that it can assume the DP register contains |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1413 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1414 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1415 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1416 >. This directive is only advice to the assembler |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1417 to determine whether an address is in the direct page and has no effect |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1418 on the contents of the DP register. The value must be fully resolved during |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1419 the first assembly pass because it affects the sizes of subsequent instructions.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1420 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1421 >This directive has no effect in the object file target.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1422 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1423 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1424 >ALIGN <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1425 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1426 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1427 >[,<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1428 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1429 >value</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1430 >]</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1431 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1432 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1433 >Force the current assembly address to be a multiple of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1434 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1435 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1436 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1437 >. If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1438 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1439 >value</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1440 > is not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1441 specified, a series of NUL bytes is output to force the alignment, if |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1442 required. Otherwise, the low order 8 bits of <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1443 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1444 >value</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1445 > |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1446 will be used as the fill. The alignment value must be fully resolved on the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1447 first pass because it affects the addresses of subsquent instructions. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1448 However, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1449 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1450 >value</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1451 > may include forward references; as |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1452 long as it resolves to a constant for the second pass, the value will be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1453 accepted.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1454 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1455 >Unless <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1456 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1457 >value</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1458 > is specified as something like $12, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1459 this directive is not suitable for inclusion in the middle of actual code. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1460 The default padding value is $00 which is intended to be used within data |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1461 blocks. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1462 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1463 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1464 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1465 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1466 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1467 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1468 ><HR><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1469 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1470 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1471 NAME="AEN432" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1472 >3.6.3. Conditional Assembly</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1473 ></H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1474 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1475 >Portions of the source code can be excluded or included based on conditions |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1476 known at assembly time. Conditionals can be nested arbitrarily deeply. The |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1477 directives associated with conditional assembly are described in this section.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1478 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1479 >All conditionals must be fully bracketed. That is, every conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1480 statement must eventually be followed by an ENDC at the same level of nesting.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1481 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1482 >Conditional expressions are only evaluated on the first assembly pass. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1483 It is not possible to game the assembly process by having a conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1484 change its value between assembly passes. Due to the underlying architecture |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1485 of LWASM, there is no possible utility to IFP1 and IFP2, nor can they, as of LWASM 3.0, actually |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1486 be implemented meaningfully. Thus there is not and never will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1487 be any equivalent of IFP1 or IFP2 as provided by other assemblers. Use of those opcodes |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1488 will throw a warning and be ignored.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1489 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1490 >It is important to note that if a conditional does not resolve to a constant |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1491 during the first parsing pass, an error will be thrown. This is unavoidable because the assembler |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1492 must make a decision about which source to include and which source to exclude at this stage. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1493 Thus, expressions that work normally elsewhere will not work for conditions.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1494 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1495 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1496 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1497 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1498 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1499 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1500 >IFEQ <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1501 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1502 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1503 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1504 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1505 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1506 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1507 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1508 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1509 > evaluates to zero, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1510 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1511 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1512 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1513 >IFNE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1514 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1515 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1516 >, IF <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1517 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1518 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1519 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1520 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1521 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1522 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1523 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1524 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1525 > evaluates to a non-zero value, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1526 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1527 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1528 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1529 >IFGT <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1530 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1531 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1532 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1533 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1534 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1535 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1536 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1537 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1538 > evaluates to a value greater than zero, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1539 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1540 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1541 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1542 >IFGE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1543 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1544 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1545 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1546 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1547 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1548 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1549 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1550 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1551 > evaluates to a value greater than or equal to zero, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1552 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1553 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1554 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1555 >IFLT <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1556 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1557 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1558 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1559 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1560 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1561 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1562 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1563 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1564 > evaluates to a value less than zero, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1565 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1566 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1567 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1568 >IFLE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1569 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1570 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1571 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1572 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1573 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1574 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1575 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1576 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1577 > evaluates to a value less than or equal to zero , the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1578 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1579 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1580 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1581 >IFDEF <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1582 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1583 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1584 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1585 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1586 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1587 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1588 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1589 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1590 > is defined at this point in the assembly |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1591 process, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1592 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1593 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1594 ><DT |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1595 >IFPRAGMA <CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1596 CLASS="PARAMETER" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1597 >pragma</CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1598 ></DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1599 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1600 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1601 >If <CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1602 CLASS="PARAMETER" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1603 >pragma</CODE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1604 > is in effect, the condition will be considered true.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1605 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
1606 ><DT |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1607 >IFNDEF <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1608 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1609 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1610 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1611 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1612 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1613 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1614 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1615 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1616 > is not defined at this point in the assembly |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1617 process, the conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1618 will be considered true.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1619 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1620 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1621 >ELSE</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1622 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1623 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1624 >If the preceding conditional at the same level of nesting was false, the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1625 statements following will be assembled. If the preceding conditional at |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1626 the same level was true, the statements following will not be assembled. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1627 Note that the preceding conditional might have been another ELSE statement |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1628 although this behaviour is not guaranteed to be supported in future versions |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1629 of LWASM.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1630 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1631 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1632 >ENDC</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1633 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1634 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1635 >This directive marks the end of a conditional construct. Every conditional |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1636 construct must end with an ENDC directive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1637 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1638 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1639 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1640 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1641 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1642 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1643 ><HR><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1644 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1645 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1646 NAME="AEN503" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1647 >3.6.4. OS9 Target Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1648 ></H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1649 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1650 >This section includes directives that apply solely to the OS9 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1651 target.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1652 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1653 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1654 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1655 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1656 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1657 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1658 >OS9 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1659 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1660 >syscall</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1661 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1662 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1663 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1664 > This directive generates a call to the specified system call. <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1665 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1666 >syscall</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1667 > may be an arbitrary expression. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1668 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1669 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1670 >MOD <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1671 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1672 >size</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1673 >,<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1674 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1675 >name</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1676 >,<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1677 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1678 >type</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1679 >,<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1680 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1681 >flags</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1682 >,<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1683 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1684 >execoff</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1685 >,<CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1686 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1687 >datasize</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1688 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1689 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1690 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1691 > This tells LWASM that the beginning of the actual module is here. It will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1692 generate a module header based on the parameters specified. It will also |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1693 begin calcuating the module CRC. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1694 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1695 > The precise meaning of the various parameters is beyond the scope of this |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1696 document since it is not a tutorial on OS9 module programming. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1697 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1698 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1699 >EMOD</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1700 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1701 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1702 > This marks the end of a module and causes LWASM to emit the calculated CRC |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1703 for the module. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1704 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1705 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1706 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1707 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1708 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1709 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1710 ><HR><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1711 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1712 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1713 NAME="AEN528" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1714 >3.6.5. Miscelaneous Directives</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1715 ></H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1716 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1717 >This section includes directives that do not fit into the other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1718 categories.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1719 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1720 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1721 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1722 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1723 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1724 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1725 >INCLUDE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1726 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1727 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1728 >, USE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1729 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1730 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1731 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1732 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1733 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1734 > Include the contents of <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1735 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1736 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1737 > at |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1738 this point in the assembly as though it were a part of the file currently |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1739 being processed. Note that if whitespace appears in the name of the file, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1740 you must enclose <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1741 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1742 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1743 > in quotes.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1744 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1745 >Note that the USE variation is provided only for compatibility with other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1746 assemblers. It is recommended to use the INCLUDE variation.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1747 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1748 >If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1749 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1750 >filename</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1751 > begins with a "/", it is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1752 interpreted as an absolute path. If it does not, the search path will be used |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1753 to find the file. First, the directory containing the file that contains this |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1754 directive. (Includes within an included file are relative to the included file, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1755 not the file that included it.) If the file is not found there, the include path |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1756 is searched. If it is still not found, an error will be thrown. Note that the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1757 current directory as understood by your shell or operating system is not searched.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1758 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1759 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1760 >END <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1761 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1762 >[expr]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1763 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1764 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1765 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1766 >This directive causes the assembler to stop assembling immediately as though |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1767 it ran out of input. For the DECB target only, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1768 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1769 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1770 > |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1771 can be used to set the execution address of the resulting binary. For all |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1772 other targets, specifying <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1773 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1774 >expr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1775 > will cause an error.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1776 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1777 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1778 >ERROR <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1779 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1780 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1781 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1782 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1783 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1784 >Causes a custom error message to be printed at this line. This will cause |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1785 assembly to fail. This directive is most useful inside conditional constructs |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1786 to cause assembly to fail if some condition that is known bad happens. Everything |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1787 from the directive to the end of the line is considered the error message.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1788 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1789 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1790 >WARNING <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1791 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1792 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1793 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1794 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1795 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1796 >Causes a custom warning message to be printed at this line. This will not cause |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1797 assembly to fail. This directive is most useful inside conditional constructs |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1798 or include files to alert the programmer to a deprecated feature being used |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1799 or some other condition that may cause trouble later, but which may, in fact, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1800 not cause any trouble.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1801 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1802 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1803 >.MODULE <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1804 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1805 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1806 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1807 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1808 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1809 >This directive is ignored for most output targets. If the output target |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1810 supports encoding a module name into it, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1811 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1812 >string</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1813 > |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1814 will be used as the module name.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1815 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1816 >As of version 3.0, no supported output targets support this directive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1817 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1818 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1819 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1820 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1821 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1822 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1823 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1824 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1825 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1826 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1827 NAME="AEN568" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1828 >3.7. Macros</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1829 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1830 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1831 >LWASM is a macro assembler. A macro is simply a name that stands in for a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1832 series of instructions. Once a macro is defined, it is used like any other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1833 assembler directive. Defining a macro can be considered equivalent to adding |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1834 additional assembler directives.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1835 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1836 >Macros may accept parameters. These parameters are referenced within a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1837 macro by the a backslash ("\") followed by a digit 1 through 9 for the first |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1838 through ninth parameters. They may also be referenced by enclosing the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1839 decimal parameter number in braces ("{num}"). The special expansion "\*" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1840 translates to the exact parameter string, including all parameters, passed |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1841 to the macro. These parameter references are replaced with the verbatim text |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1842 of the parameter passed to the macro. A reference to a non-existent |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1843 parameter will be replaced by an empty string. Macro parameters are expanded |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1844 everywhere on each source line. That means the parameter to a macro could be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1845 used as a symbol or it could even appear in a comment or could cause an |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1846 entire source line to be commented out when the macro is expanded. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1847 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1848 >Parameters passed to a macro are separated by commas and the parameter list |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1849 is terminated by any whitespace. This means that neither a comma nor whitespace |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1850 may be included in a macro parameter.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1851 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1852 >Macro expansion is done recursively. That is, within a macro, macros are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1853 expanded. This can lead to infinite loops in macro expansion. If the assembler |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1854 hangs for a long time while assembling a file that uses macros, this may be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1855 the reason.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1856 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1857 >Each macro expansion receives its own local symbol context which is not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1858 inherited by any macros called by it nor is it inherited from the context |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1859 the macro was instantiated in. That means it is possible to use local symbols |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1860 within macros without having them collide with symbols in other macros or |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1861 outside the macro itself. However, this also means that using a local symbol |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1862 as a parameter to a macro, while legal, will not do what it would seem to do |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1863 as it will result in looking up the local symbol in the macro's symbol context |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1864 rather than the enclosing context where it came from, likely yielding either |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1865 an undefined symbol error or bizarre assembly results.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1866 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1867 >Note that there is no way to define a macro as local to a symbol context. All |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1868 macros are part of the global macro namespace. However, macros have a separate |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1869 namespace from symbols so it is possible to have a symbol with the same name |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1870 as a macro.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1871 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1872 >Macros are defined only during the first pass. Macro expansion also |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1873 only occurs during the first pass. On the second pass, the macro |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1874 definition is simply ignored. Macros must be defined before they are used.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1875 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1876 >The following directives are used when defining macros.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1877 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1878 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1879 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1880 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1881 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1882 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1883 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1884 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1885 >macroname</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1886 > MACRO [NOEXPAND]</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1887 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1888 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1889 >This directive is used to being the definition of a macro called |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1890 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1891 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1892 >macroname</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1893 >. If <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1894 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1895 >macroname</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1896 > already |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1897 exists, it is considered an error. Attempting to define a macro within a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1898 macro is undefined. It may work and it may not so the behaviour should not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1899 be relied upon.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1900 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1901 >If NOEXPAND is specified, the macro will not be expanded in a program |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1902 listing. Instead, all bytes emitted by all instructions within the macro |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1903 will appear to be emitted on the line where the macro is invoked, starting |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1904 at the address of the line of the invokation. If the macro uses ORG or other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1905 directives that define symbols or change the assembly address, these things |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1906 will also be hidden (except in the symbol table) and the output bytes will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1907 appear with incorrect address attribution. Thus, NOEXPAND should only be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1908 used for macros that do not mess with the assembly address or otherwise |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1909 define symbols that should be visible.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1910 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1911 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1912 >ENDM</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1913 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1914 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1915 >This directive indicates the end of the macro currently being defined. It |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1916 causes the assembler to resume interpreting source lines as normal.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1917 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1918 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1919 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1920 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1921 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1922 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1923 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1924 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1925 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
1926 NAME="AEN591" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1927 >3.8. Structures</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1928 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1929 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1930 > Structures are used to group related data in a fixed structure. A structure |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1931 consists a number of fields, defined in sequential order and which take up |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1932 specified size. The assembler does not enforce any means of access within a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1933 structure; it assumes that whatever you are doing, you intended to do. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1934 There are two pseudo ops that are used for defining structures. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1935 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1936 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1937 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1938 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1939 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1940 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1941 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1942 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1943 >structname</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1944 > STRUCT</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1945 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1946 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1947 > This directive is used to begin the definition of a structure with name |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1948 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1949 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1950 >structname</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1951 >. Subsequent statements all form part of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1952 the structure definition until the end of the structure is declared. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1953 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1954 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1955 >ENDSTRUCT, ENDS</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1956 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1957 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1958 >This directive ends the definition of the structure. ENDSTRUCT is the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1959 preferred form. Prior to version 3.0 of LWASM, ENDS was used to end a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1960 section instead of a structure.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1961 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1962 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1963 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1964 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1965 > Within a structure definition, only reservation pseudo ops are permitted. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1966 Anything else will cause an assembly error.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1967 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1968 > Once a structure is defined, you can reserve an area of memory in the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1969 same structure by using the structure name as the opcode. Structures can |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1970 also contain fields that are themselves structures. See the example |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1971 below.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1972 ><PRE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1973 CLASS="PROGRAMLISTING" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1974 >tstruct2 STRUCT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1975 f1 rmb 1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1976 f2 rmb 1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1977 ENDSTRUCT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1978 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1979 tstruct STRUCT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1980 field1 rmb 2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1981 field2 rmb 3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1982 field3 tstruct2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1983 ENDSTRUCT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1984 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1985 ORG $2000 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1986 var1 tstruct |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1987 var2 tstruct2</PRE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1988 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1989 >Fields are referenced using a dot (.) as a separator. To refer to the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1990 generic offset within a structure, use the structure name to the left of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1991 dot. If referring to a field within an actual variable, use the variable's |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1992 symbol name to the left of the dot.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1993 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1994 >You can also refer to the actual size of a structure (or a variable |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1995 declared as a structure) using the special symbol sizeof{structname} where |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1996 structname will be the name of the structure or the name of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1997 variable.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1998 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
1999 >Essentially, structures are a shortcut for defining a vast number of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2000 symbols. When a structure is defined, the assembler creates symbols for the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2001 various fields in the form structname.fieldname as well as the appropriate |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2002 sizeof{structname} symbol. When a variable is declared as a structure, the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2003 assembler does the same thing using the name of the variable. You will see |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2004 these symbols in the symbol table when the assembler is instructed to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2005 provide a listing. For instance, the above listing will create the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2006 following symbols (symbol values in parentheses): tstruct2.f1 (0), |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2007 tstruct2.f2 (1), sizeof{tstruct2} (2), tstruct.field1 (0), tstruct.field2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2008 (2), tstruct.field3 (5), tstruct.field3.f1 (5), tstruct.field3.f2 (6), |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2009 sizeof{tstruct.field3} (2), sizeof{tstruct} (7), var1 {$2000}, var1.field1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2010 {$2000}, var1.field2 {$2002}, var1.field3 {$2005}, var1.field3.f1 {$2005}, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2011 var1.field3.f2 {$2006}, sizeof(var1.field3} (2), sizeof{var1} (7), var2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2012 ($2007), var2.f1 ($2007), var2.f2 ($2008), sizeof{var2} (2). </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2013 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2014 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2015 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2016 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2017 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2018 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
2019 NAME="AEN612" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2020 >3.9. Object Files and Sections</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2021 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2022 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2023 >The object file target is very useful for large project because it allows |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2024 multiple files to be assembled independently and then linked into the final |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2025 binary at a later time. It allows only the small portion of the project |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2026 that was modified to be re-assembled rather than requiring the entire set |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2027 of source code to be available to the assembler in a single assembly process. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2028 This can be particularly important if there are a large number of macros, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2029 symbol definitions, or other metadata that uses resources at assembly time. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2030 By far the largest benefit, however, is keeping the source files small enough |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2031 for a mere mortal to find things in them.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2032 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2033 >With multi-file projects, there needs to be a means of resolving references to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2034 symbols in other source files. These are known as external references. The |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2035 addresses of these symbols cannot be known until the linker joins all the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2036 object files into a single binary. This means that the assembler must be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2037 able to output the object code without knowing the value of the symbol. This |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2038 places some restrictions on the code generated by the assembler. For |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2039 example, the assembler cannot generate direct page addressing for instructions |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2040 that reference external symbols because the address of the symbol may not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2041 be in the direct page. Similarly, relative branches and PC relative addressing |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2042 cannot be used in their eight bit forms. Everything that must be resolved |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2043 by the linker must be assembled to use the largest address size possible to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2044 allow the linker to fill in the correct value at link time. Note that the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2045 same problem applies to absolute address references as well, even those in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2046 the same source file, because the address is not known until link time.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2047 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2048 >It is often desired in multi-file projects to have code of various types grouped |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2049 together in the final binary generated by the linker as well. The same applies |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2050 to data. In order for the linker to do that, the bits that are to be grouped |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2051 must be tagged in some manner. This is where the concept of sections comes in. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2052 Each chunk of code or data is part of a section in the object file. Then, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2053 when the linker reads all the object files, it coalesces all sections of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2054 same name into a single section and then considers it as a unit.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2055 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2056 >The existence of sections, however, raises a problem for symbols even |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2057 within the same source file. Thus, the assembler must treat symbols from |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2058 different sections within the same source file in the same manner as external |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2059 symbols. That is, it must leave them for the linker to resolve at link time, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2060 with all the limitations that entails.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2061 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2062 >In the object file target mode, LWASM requires all source lines that |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2063 cause bytes to be output to be inside a section. Any directives that do |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2064 not cause any bytes to be output can appear outside of a section. This includes |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2065 such things as EQU or RMB. Even ORG can appear outside a section. ORG, however, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2066 makes no sense within a section because it is the linker that determines |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2067 the starting address of the section's code, not the assembler.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2068 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2069 >All symbols defined globally in the assembly process are local to the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2070 source file and cannot be exported. All symbols defined within a section are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2071 considered local to the source file unless otherwise explicitly exported. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2072 Symbols referenced from external source files must be declared external, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2073 either explicitly or by asking the assembler to assume that all undefined |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2074 symbols are external.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2075 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2076 >It is often handy to define a number of memory addresses that will be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2077 used for data at run-time but which need not be included in the binary file. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2078 These memory addresses are not initialized until run-time, either by the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2079 program itself or by the program loader, depending on the operating environment. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2080 Such sections are often known as BSS sections. LWASM supports generating |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2081 sections with a BSS attribute set which causes the section definition including |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2082 symbols exported from that section and those symbols required to resolve |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2083 references from the local file, but with no actual code in the object file. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2084 It is illegal for any source lines within a BSS flagged section to cause any |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2085 bytes to be output.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2086 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2087 >The following directives apply to section handling.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2088 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2089 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2090 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2091 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2092 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2093 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2094 >SECTION <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2095 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2096 >name[,flags]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2097 >, SECT <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2098 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2099 >name[,flags]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2100 >, .AREA <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2101 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2102 >name[,flags]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2103 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2104 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2105 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2106 >Instructs the assembler that the code following this directive is to be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2107 considered part of the section <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2108 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2109 >name</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2110 >. A section name |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2111 may appear multiple times in which case it is as though all the code from |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2112 all the instances of that section appeared adjacent within the source file. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2113 However, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2114 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2115 >flags</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2116 > may only be specified on the first |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2117 instance of the section.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2118 ><P |
168 | 2119 ><CODE |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2120 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2121 >flags</CODE |
168 | 2122 > is a comma separated list of flags. If a |
2123 flag is "bss", the section will be treated as a BSS section and no | |
2124 statements that generate output are permitted.</P | |
2125 ><P | |
2126 >If the flag is "constant", | |
2127 the same restrictions apply as for BSS sections. Additionally, all symbols | |
2128 defined in a constant section define absolute values and will not be | |
2129 adjusted by the linker at link time. Constant sections cannot define | |
2130 complex expressions for symbols; the value must be fully defined at assembly | |
2131 time. Additionally, multiple instances of a constant section do not | |
2132 coalesce into a single addressing unit; each instance starts again at offset | |
2133 0.</P | |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2134 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2135 >If the section name is "bss" or ".bss" in any combination of upper and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2136 lower case, the section is assumed to be a BSS section. In that case, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2137 the flag <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2138 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2139 >!bss</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2140 > can be used to override this assumption.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2141 ><P |
168 | 2142 > If the section name is "_constants" or "_constant", in any |
2143 combination of upper and lower case, the section is assumed to be a constant | |
2144 section. This assumption can be overridden with the "!constant" | |
2145 flag.</P | |
2146 ><P | |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2147 >If assembly is already happening within a section, the section is implicitly |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2148 ended and the new section started. This is not considered an error although |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2149 it is recommended that all sections be explicitly closed.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2150 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2151 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2152 >ENDSECTION, ENDSECT</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2153 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2154 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2155 >This directive ends the current section. This puts assembly outside of any |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2156 sections until the next SECTION directive. ENDSECTION is the preferred form. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2157 Prior to version 3.0 of LWASM, ENDS could also be used to end a section but |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2158 as of version 3.0, it is now an alias for ENDSTRUCT instead.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2159 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2160 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2161 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2162 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2163 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2164 > EXTERN, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2165 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2166 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2167 > EXTERNAL, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2168 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2169 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2170 > IMPORT</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2171 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2172 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2173 >This directive defines <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2174 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2175 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2176 > as an external symbol. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2177 This directive may occur at any point in the source code. EXTERN definitions |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2178 are resolved on the first pass so an EXTERN definition anywhere in the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2179 source file is valid for the entire file. The use of this directive is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2180 optional when the assembler is instructed to assume that all undefined |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2181 symbols are external. In fact, in that mode, if the symbol is referenced |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2182 before the EXTERN directive, an error will occur.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2183 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2184 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2185 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2186 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2187 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2188 > EXPORT, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2189 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2190 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2191 > .GLOBL, EXPORT <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2192 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2193 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2194 >, .GLOBL <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2195 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2196 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2197 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2198 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2199 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2200 >This directive defines <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2201 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2202 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2203 > as an exported symbol. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2204 This directive may occur at any point in the source code, even before the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2205 definition of the exported symbol.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2206 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2207 >Note that <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2208 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2209 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2210 > may appear as the operand or as the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2211 statement's symbol. If there is a symbol on the statement, that will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2212 take precedence over any operand that is present.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2213 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2214 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2215 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2216 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2217 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2218 > EXTDEP</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2219 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2220 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2221 >This directive forces an external dependency on |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2222 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2223 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2224 >sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2225 >, even if it is never referenced anywhere else in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2226 this file.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2227 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2228 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2229 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2230 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2231 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2232 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2233 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2234 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2235 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
2236 NAME="AEN676" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2237 >3.10. Assembler Modes and Pragmas</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2238 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2239 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2240 >There are a number of options that affect the way assembly is performed. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2241 Some of these options can only be specified on the command line because |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2242 they determine something absolute about the assembly process. These include |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2243 such things as the output target. Other things may be switchable during |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2244 the assembly process. These are known as pragmas and are, by definition, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2245 not portable between assemblers.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2246 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2247 >LWASM supports a number of pragmas that affect code generation or |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2248 otherwise affect the behaviour of the assembler. These may be specified by |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2249 way of a command line option or by assembler directives. The directives |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2250 are as follows.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2251 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2252 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2253 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2254 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2255 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2256 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2257 >PRAGMA <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2258 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2259 >pragma[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2260 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2261 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2262 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2263 >Specifies that the assembler should bring into force all <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2264 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2265 >pragma</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2266 >s |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2267 specified. Any unrecognized pragma will cause an assembly error. The new |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2268 pragmas will take effect immediately. This directive should be used when |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2269 the program will assemble incorrectly if the pragma is ignored or not supported.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2270 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2271 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2272 >*PRAGMA <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2273 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2274 >pragma[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2275 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2276 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2277 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2278 >This is identical to the PRAGMA directive except no error will occur with |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2279 unrecognized or unsupported pragmas. This directive, by virtue of starting |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2280 with a comment character, will also be ignored by assemblers that do not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2281 support this directive. Use this variation if the pragma is not required |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2282 for correct functioning of the code.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2283 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2284 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2285 >*PRAGMAPUSH <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2286 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2287 >pragma[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2288 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2289 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2290 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2291 >This directive saves the current state of the specified pragma(s) for later retrieval. See discussion below for more information.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2292 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2293 >This directive will not throw any errors for any reason.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2294 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2295 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2296 >*PRAGMAPOP <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2297 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2298 >pragma[,...]</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2299 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2300 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2301 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2302 >This directive restores the previously saved state of the specified pragma(s). See discussion below for more information.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2303 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2304 >This directive will not throw any errors for any reason.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2305 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2306 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2307 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2308 ><P |
231
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2309 >Each pragma supported has a positive version and a negative version. |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2310 The positive version enables the pragma while the negative version disables |
231
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2311 it. The negatitve version is simply the positive version with "no" prefixed |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2312 to it. For instance, "pragma" vs. "nopragma". When only one version is |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2313 listed below, its opposite can be obtained by prepending "no" if it is not |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2314 present or removing "no" from the beginning if it is present.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2315 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2316 >Pragmas are not case sensitive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2317 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2318 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2319 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2320 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2321 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2322 ><DT |
333
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2323 >6800compat</DT |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2324 ><DD |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2325 ><P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2326 >When in force, this pragma enables recognition of various |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2327 compatibility instructions useful when assembling 6800 code. These |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2328 compatibility instructions are assembled into equivalent 6809 instructions. |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2329 This mode also includes several analogous instructions which are not |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2330 strictly 6800 instructions but allow the similar style to be applied to 6809 |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2331 specific features.</P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2332 ><P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2333 >Technically, a compliant 6809 assembler must recognize these |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2334 instructions by default since Motorola advertised the 6809 as being source |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2335 compatible with the 6800. However, most source code does not require this |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2336 compatibility and LWASM itself did not support these instructions prior to |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2337 version 4.11 so this mode is disabled by default.</P |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2338 ></DD |
507f442dc71e
Add support for 6800 compatibility instructions.
William Astle <lost@l-w.ca>
parents:
324
diff
changeset
|
2339 ><DT |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2340 >6809</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2341 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2342 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2343 >This pragma allows you to mark a section of code as 6809-only. In ths mode, |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2344 the assembler will throw an error if any 6309 instructions are used.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2345 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2346 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2347 >6309</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2348 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2349 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2350 >This pragma enables the use of 6309 instructions and disables any 6809 specific |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2351 instructions. It also changes the cycle count listing output (if selected) |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2352 to display 6309 timings.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2353 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2354 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2355 >6809conv, 6309conv</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2356 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2357 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2358 >These pragmas enable convenience instructions extending the 6809 and 6309 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2359 instruction sets respectively. For more information, see |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2360 <A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2361 HREF="#CONVINST" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2362 >Section 3.11</A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2363 >.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2364 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2365 ><DT |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2366 >index0tonone</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2367 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2368 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2369 >When in force, this pragma enables an optimization affecting indexed addressing |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2370 modes. When the offset expression in an indexed mode evaluates to zero but is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2371 not explicity written as 0, this will replace the operand with the equivalent |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2372 no offset mode, thus creating slightly faster code. Because of the advantages |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2373 of this optimization, it is enabled by default.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2374 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2375 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2376 >cescapes</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2377 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2378 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2379 >This pragma will cause strings in the FCC, FCS, and FCN pseudo operations to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2380 have C-style escape sequences interpreted. The one departure from the official |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2381 spec is that unrecognized escape sequences will return either the character |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2382 immediately following the backslash or some undefined value. Do not rely |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2383 on the behaviour of undefined escape sequences.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2384 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2385 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2386 >importundefexport</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2387 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2388 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2389 >This pragma is only valid for targets that support external references. When |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2390 in force, it will cause the EXPORT directive to act as IMPORT if the symbol |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2391 to be exported is not defined. This is provided for compatibility with the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2392 output of gcc6809 and should not be used in hand written code. Because of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2393 the confusion this pragma can cause, it is disabled by default.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2394 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2395 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2396 >undefextern</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2397 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2398 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2399 >This pragma is only valid for targets that support external references. When in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2400 force, if the assembler sees an undefined symbol on the second pass, it will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2401 automatically define it as an external symbol. This automatic definition will |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2402 apply for the remainder of the assembly process, even if the pragma is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2403 subsequently turned off. Because this behaviour would be potentially surprising, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2404 this pragma defaults to off.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2405 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2406 >The primary use for this pragma is for projects that share a large number of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2407 symbols between source files. In such cases, it is impractical to enumerate |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2408 all the external references in every source file. This allows the assembler |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2409 and linker to do the heavy lifting while not preventing a particular source |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2410 module from defining a local symbol of the same name as an external symbol |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2411 if it does not need the external symbol. (This pragma will not cause an |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2412 automatic external definition if there is already a locally defined symbol.)</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2413 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2414 >This pragma will often be specified on the command line for large projects. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2415 However, depending on the specific dynamics of the project, it may be sufficient |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2416 for one or two files to use this pragma internally.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2417 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2418 ><DT |
253 | 2419 >export</DT |
2420 ><DD | |
2421 ><P | |
2422 >This pragma causes all symbols to be added to the export list | |
2423 automatically. This is useful when a large number of symbols need to be | |
2424 exported but you do not wish to include an EXPORT directive for all of them. | |
2425 This is often useful on the command line but might be useful even inline | |
2426 with the PRAGMA directive if a large number of symbols in a row are to be | |
2427 exported.</P | |
2428 ></DD | |
2429 ><DT | |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2430 >dollarlocal</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2431 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2432 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2433 >When set, a "$" in a symbol makes it local. When not set, "$" does not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2434 cause a symbol to be local. It is set by default except when using the OS9 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2435 target.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2436 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2437 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2438 >dollarnotlocal</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2439 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2440 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2441 > This is the same as the "dollarlocal" pragma except its sense is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2442 reversed. That is, "dollarlocal" and "nodollarnotlocal" are equivalent and |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2443 "nodollarlocal" and "dollarnotlocal" are equivalent. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2444 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2445 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2446 >pcaspcr</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2447 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2448 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2449 > Normally, LWASM makes a distinction between PC and PCR in program |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2450 counter relative addressing. In particular, the use of PC means an absolute |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2451 offset from PC while PCR causes the assembler to calculate the offset to the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2452 specified operand and use that as the offset from PC. By setting this |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2453 pragma, you can have PC treated the same as PCR. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2454 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2455 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2456 >shadow</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2457 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2458 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2459 >When this pragma is in effect, it becomes possible to define a macro |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2460 that matches an internal operation code. Thus, it makes it possible to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2461 redefine either CPU instructions or pseudo operations. Because this feature |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2462 is of dubious utility, it is disabled by default.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2463 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2464 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2465 >nolist</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2466 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2467 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2468 >Lines where this pragma is in effect will not appear in the assembly |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2469 listing. Also, any symbols defined under this pragma will not show up in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2470 the symbol list. This is most useful in include files to avoid spamming the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2471 assembly listing with dozens, hundreds, or thousands of irrelevant |
563
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2472 symbols. It is important to note that this pragma will not hide lines that |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2473 generate output to the binary.</P |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2474 ></DD |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2475 ><DT |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2476 >nolistcode</DT |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2477 ><DD |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2478 ><P |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2479 >Lines where this pragma is in effect will not appear in the assembly |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2480 listing. Also, any symbols defined under this pragma will not show up in |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2481 the symbol list. This is most useful in include files to avoid spamming the |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2482 assembly listing with dozens, hundreds, or thousands of irrelevant |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2483 symbols. Unlike "nolist", this pragma will hide lines that generate output |
8c6c3363e18e
Update manual to reflect pragma nolistcode and correct nolist semantics
William Astle <lost@l-w.ca>
parents:
533
diff
changeset
|
2484 to the binary.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2485 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2486 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2487 >autobranchlength</DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2488 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2489 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2490 >One of the perennial annoyances for 6809 programmers is that the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2491 mneumonics for the short and long branch instructions are different (bxx vs. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2492 lbxx), which is at odds with the rest of the instruction set. This pragma |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2493 is a solution to those annoying byte overflow errors that short branch |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2494 instructions tend to aquire.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2495 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2496 >When this pragma is in effect, which is not the default, whenever any |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2497 relative branch instruction is used, its size will be automatically |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2498 determined based on the actual distance to the destination. In other words, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2499 one can write code with long or short branches everywhere and the assembler |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2500 will choose a size for the branch.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2501 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2502 >Also, while this pragma is in effect, the > and < symbols can be used |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2503 to force the branch size, analogous to their use for other instructions with |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2504 < forcing 8 bit offsets and > forcing 16 bit offets.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2505 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2506 >Because this pragma leads to source that is incompatible with other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2507 assemblers, it is strongly recommended that it be invoked using the PRAGMA |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2508 directive within the source code rather than on the command line or via the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2509 *PRAGMA directive. This way, an error will be raised if someone tries to |
231
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2510 assemble the code under a different assembler.</P |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2511 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2512 >Note that if the "forwardrefmax" pragma is ineffect, as is the current |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2513 default, this pragma will not behave as expected.</P |
231
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2514 ></DD |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2515 ><DT |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2516 >nosymbolcase, symbolnocase</DT |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2517 ><DD |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2518 ><P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2519 >Any symbol defined while this pragma is in force will be treated as |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2520 case insensitive, regardless whether the pragma is in force when the symbol |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2521 is referenced.</P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2522 ><P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2523 >It is important to note that this pragma will not work as expected in |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2524 all cases when using the object file assembly target. It is intended for |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2525 use only when the assembler will be producing the final binary.</P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2526 ></DD |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2527 ><DT |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2528 >condundefzero</DT |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2529 ><DD |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2530 ><P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2531 >This pragma will cause the assembler to change the way it handles |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2532 symbols in conditional expressions. Ordinarily, any symbol that is not |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2533 defined prior to the conditional will throw an undefined symbol error. With |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2534 this pragma in effect, symbols that are not yet defined at the point the |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2535 conditional is encountered will be treated as zero.</P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2536 ><P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2537 >This is not the default because it encourages poor code design. One |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2538 should use the "IFDEF" or "IFNDEF" conditionals to test for the presence of |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2539 a symbol.</P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2540 ><P |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2541 >It is important to note that if a symbol is defined but it does not |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2542 yet evaluate to a constant value at the point where the conditional appears, |
2cc599f1bebf
Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
168
diff
changeset
|
2543 the assembler will still complain about a non constant condition.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2544 ></DD |
347
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2545 ><DT |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2546 >forwardrefmax</DT |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2547 ><DD |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2548 ><P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2549 >This pragma will disable forward reference optimization completely. |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2550 However, many source files, especially |
347
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2551 those not using the PCR relative addressing modes, this optimization is |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2552 pointless since the assembler will almost certainly settle on a 16 bit |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2553 offset or address. If all variables in the direct page are defined before |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2554 the main body of the code, the benefit of forward reference optimization |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2555 almost certainly vanishes completely. However, the cost of doing that |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2556 optimization remains and can result in a very long assembly time. Because |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2557 of this, "forwardrefmax" has been the default setting since version 4.14 of |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
489
diff
changeset
|
2558 LWTOOLS. To turn it off, use "noforwardrefmax".</P |
347
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2559 ><P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2560 >Enabling this pragma will cause all forward references to use the |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2561 maximum offset or address size, much the same has EDTASM and other pure |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2562 two pass assemblers do. The side effect is that all line lengths and |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2563 symbol values are fully resolved after the initial parsing pass and the |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2564 amount of work to resolve everything becomes almost nil.</P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2565 ><P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2566 >While this pragma can be applied selectively to sections of source |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2567 code (use *PRAGMA if doing so and compatibility with other assemblers |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2568 is desired), it is likely more useful when provided as a command line |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2569 pragma.</P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2570 ><P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2571 >It should be noted that the presence or absence of this pragma |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2572 will not change the correctness of the generated code unless cycle counts |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2573 or byte counts are critical (which they usually are not). It also will |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2574 not override the operand size override prefixes (< and >). It only |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2575 applies when the assembler is left to guess what the operand size is.</P |
330a66a0f45a
Document the forwardrefmax pragma
William Astle <lost@l-w.ca>
parents:
345
diff
changeset
|
2576 ></DD |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2577 ><DT |
455 | 2578 >operandsizewarning</DT |
2579 ><DD | |
2580 ><P | |
2581 >Enabling this pragma will cause LWASM to show a warning when it | |
2582 detects that a smaller addressing mode could be used for an instruction. | |
2583 This is particularly useful for finding places where long branches are used | |
2584 where short branches could be used instead. It will also show the warnings | |
2585 for indexing offsets (regardless of whether the operand size is | |
2586 forced).</P | |
2587 ><P | |
2588 >As of LWASM 4.16, no other checks are performed.</P | |
2589 ></DD | |
2590 ><DT | |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2591 >qrts</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2592 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2593 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2594 > Enables the use of the ?RTS branch target. ?RTS is implemented to maintain |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2595 compatibility with the MACRO-80c assembler. It works by searching backward |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2596 in the code for an RTS instruction. If none is found, it inverts the branch |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2597 logic and inserts an RTS following the branch instruction. Below you can |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2598 see how a BMI (2B xx) has been assembled as a BPL *+1 (2A 01) to skip over an |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2599 inserted RTS (39).</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2600 ><PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2601 CLASS="PROGRAMLISTING" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2602 >1D1E 7D1D1D TST WHICH1 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2603 1D21 2A0139 BMI ?RTS |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2604 1D24 BD1D65 JSR INV</PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2605 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2606 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2607 >m80ext</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2608 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2609 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2610 > This pragma (along with pragma qrts) enables some uncommon behaviors to |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2611 accomodate The Micro Works MACRO-80c assembler from 1982. This assembler |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2612 was used by a number of notable TRS-80 Color Computer applications and the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2613 goal of this pragma is to allow them to build identical binaries from |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2614 unmodified, vintage source code.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2615 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2616 > In m80ext mode, the handling of the "END" pseudo-op changes when used inside |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2617 an include file. Instead of terminating all assembly, it merely stops |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2618 processing of the current include file (this behavior matches the original |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2619 Motorola 6809 assembler). In addition, loading an ASCII value with a single |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2620 quote (e.g., LDA #'N) is extended to 16-bit registers (e.g., LDD #'NO). |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2621 LWASM normally supports this via double quote and that is the proper use in |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2622 modern code. Finally, the FCC pseudo-op is extended to handle FCB-like |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2623 behavior after the closing delimiter:</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2624 ><PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2625 CLASS="PROGRAMLISTING" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2626 > FCC "Greetings from 1982",13,0</PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2627 ></DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2628 ><DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2629 >testmode</DT |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2630 ><DD |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2631 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2632 > This pragma is intended for internal testing purposes. In testmode, the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2633 assembler searches for a specially-formatted comment starting with a |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2634 semicolon followed by a period. Immediately afterward are a list of hex |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2635 bytes that the assembler is expected to generate. Likewise, if the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2636 assembler is expected to throw an error or warning on a given line, you can |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2637 check by specifying "E:" followed by the error number. In this case the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2638 error is ignored and the assembler continues ignoring the line in question. </P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2639 ><PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2640 CLASS="PROGRAMLISTING" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2641 >1D1E 7D1D1D TST WHICH1 ;.7d1d1d |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2642 1D21 2A0139 BMI ?RTS ;.2a0139 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2643 1D24 1D24 FDB * ;.1d24 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2644 1D26 xyz INV ;.E:32 (Error 32 is "Bad opcode")</PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2645 ></DD |
478
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2646 ><DT |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2647 >emuext</DT |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2648 ><DD |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2649 ><P |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2650 > This pragma enables two instructions useful when running code in compatible |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2651 emulators. Break breaks into the debugger. Log writes printf-style |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2652 output to the debug window </P |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2653 ><PRE |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2654 CLASS="PROGRAMLISTING" |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2655 > LOG ; log output |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2656 FDB FSTR ; pointer to format string |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2657 FDB PX1 ; 16 bit pointer to 16 bit value |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2658 FDB PY1 ; 16 bit pointer to 8 bit value (see format string!) |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2659 FDB PX2 ; 16 bit pointer to 16 bit value |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2660 FDB PY2 ; 16 bit pointer to 8 bit value |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2661 ; execution continues here ... |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2662 RTS |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2663 |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2664 ; format string |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2665 FSTR FCC "%hu,%hhu - %hu,%hhu" |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2666 FCB 10,0</PRE |
a71206ed966c
Update manual in preparation for release
William Astle <lost@l-w.ca>
parents:
455
diff
changeset
|
2667 ></DD |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2668 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2669 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2670 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2671 >As a convenience, each input file has a pragma state stack. This |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2672 allows, through the use of *PRAGMAPUSH and *PRAGMAPOP, a file to change a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2673 pragma state and then restore it to the precise state it had previously. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2674 If, at the end of an input file, all pragma states have not been popped, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2675 they will be removed from the stack. Thus, it is critical to employ |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2676 *PRAGMAPOP correctly. Because each input file has its own pragma stack, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2677 using *PRAGMAPUSH in one file and *PRAGMAPOP in another file will not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2678 work.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2679 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2680 >Pragma stacks are more useful in include files, in particular in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2681 conjunction with the nolist pragma. One can push the state of the nolist |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2682 pragma, engage the nolist pragma, and then pop the state of the nolist |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2683 pragma at the end of the include file. This will cause the entire include |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2684 file to operate under the nolist pragma. However, if the file is included |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2685 while nolist is already engaged, it will not undo that state.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2686 ></DIV |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2687 ><DIV |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2688 CLASS="SECTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2689 ><HR><H2 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2690 CLASS="SECTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2691 ><A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2692 NAME="CONVINST" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2693 >3.11. Convenience Instructions</A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2694 ></H2 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2695 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2696 > Similar to the 6800 compatibility instructions (pragma 6800compat) these |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2697 pragma 6809conv and pragma 6309conv enable convenience extensions to the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2698 6809 and 6309 instruction set. Originally intended for compatibility with |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2699 the MACRO-80c assembler, these have proven useful in large codebases that |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2700 target both the 6809 and the 6309.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2701 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2702 > The 6809 extensions are straightforward with the exception of "TSTD" which |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2703 assembles as "STD -2,S". A benefit of using these is they will "just work" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2704 and take on their 6309 equivalent when you enable 6309 assembly mode. |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2705 Supported instructions: ASRD, CLRD, COMD, LSLD, LSRD, NEGD, TSTD.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2706 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2707 > 6309 extensions are based on common patterns described by Chris Burke and |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2708 Darren Atkinson in their 6309 documentation and include the following |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2709 instructions: ASRQ, CLRQ, COMQ, LSLE, LSLF, LSLQ, LSRQ, NEGE, |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2710 NEGF, NEGW, NEGQ, TSTQ.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2711 ></DIV |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2712 ><DIV |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2713 CLASS="SECTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2714 ><HR><H2 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2715 CLASS="SECTION" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2716 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
2717 NAME="AEN832" |
394
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2718 >3.12. Cycle Counts</A |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2719 ></H2 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2720 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2721 > The following options for displaying cycle counts in listings are provided. |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2722 These options are enabled from pragmas on the command line or in the |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2723 assembly files themselves. For compatibility with other assemblers you can |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2724 use the "OPT" keyword in addition to "PRAGMA."</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2725 ><PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2726 CLASS="PROGRAMLISTING" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2727 >opt c - enable cycle counts: [8] |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2728 opt cd - enable detailed cycle counts breaking down addressing modes: [5+3] |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2729 opt ct - show a running subtotal of cycles |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2730 opt cc - clear the running subtotal</PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2731 ><P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2732 > The assembler supports both 6809 as well as native-mode 6309 cycle counts. |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2733 In 6309 mode the counts are displayed in parenthesis instead of brackets. |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2734 In addition, some operations have a variable cycle count. In this case a |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2735 "+?" is displayed to alert the reader. Sample output is shown below.</P |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2736 ><PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2737 CLASS="PROGRAMLISTING" |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2738 >266f 7d25e2 (window.asm):00313 [7] 7 move tst putflg |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2739 2672 2602 (window.asm):00314 [5] 12 bne a@ |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2740 2674 1e13 (window.asm):00315 [8] 20 exg x,u |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2741 2676 0dd6 (window.asm):00316 [6] 26 a@ tst is6309 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2742 2678 2618 (window.asm):00317 [5] 31 bne exit@ |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2743 (window.asm):00318 opt 6309 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2744 267a 10860085 (window.asm):00319 (4) 35 b@ ldw #133 |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2745 267e 113813 (window.asm):00320 (6+?) 41 tfm x+,u+ |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2746 2681 30881b (window.asm):00321 (4+1) 46 leax 27,x |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2747 2684 33c81b (window.asm):00322 (4+1) 51 leau 27,u |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2748 2687 4a (window.asm):00323 (1) 52 deca |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2749 2688 26f0 (window.asm):00324 (5) 57 bne b@</PRE |
fc166b3bbae3
Update manual for recent additions.
William Astle <lost@l-w.ca>
parents:
369
diff
changeset
|
2750 ></DIV |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2751 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2752 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2753 CLASS="CHAPTER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2754 ><HR><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2755 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
2756 NAME="AEN838" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2757 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2758 >Chapter 4. LWLINK</H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2759 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2760 >The LWTOOLS linker is called LWLINK. This chapter documents the various features |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2761 of the linker.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2762 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2763 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2764 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2765 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2766 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
2767 NAME="AEN841" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2768 >4.1. Command Line Options</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2769 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2770 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2771 >The binary for LWLINK is called "lwlink". Note that the binary is in lower |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2772 case. lwlink takes the following command line arguments.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2773 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2774 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2775 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2776 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2777 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2778 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2779 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2780 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2781 >--decb</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2782 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2783 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2784 >-b</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2785 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2786 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2787 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2788 >Selects the DECB output format target. This is equivalent to <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2789 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2790 >--format=decb</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2791 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2792 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2793 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2794 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2795 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2796 >--output=FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2797 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2798 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2799 >-o FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2800 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2801 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2802 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2803 >This option specifies the name of the output file. If not specified, the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2804 default is <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2805 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2806 >a.out</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2807 >.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2808 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2809 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2810 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2811 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2812 >--format=TYPE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2813 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2814 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2815 >-f TYPE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2816 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2817 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2818 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2819 >This option specifies the output format. Valid values are <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2820 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2821 >decb</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2822 > |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2823 and <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2824 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2825 >raw</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2826 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2827 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2828 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2829 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2830 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2831 >--raw</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2832 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2833 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2834 >-r</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2835 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2836 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2837 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2838 >This option specifies the raw output format. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2839 It is equivalent to <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2840 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2841 >--format=raw</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2842 > |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2843 and <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2844 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2845 >-f raw</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2846 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2847 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2848 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2849 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2850 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2851 >--script=FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2852 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2853 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2854 >-s</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2855 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2856 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2857 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2858 >This option allows specifying a linking script to override the linker's |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2859 built in defaults.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2860 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2861 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2862 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2863 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2864 >--section-base=SECT=BASE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2865 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2866 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2867 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2868 >Cause section SECT to load at base address BASE. This will be prepended |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2869 to the built-in link script. It is ignored if a link script is provided.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2870 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2871 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2872 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2873 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2874 >--map=FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2875 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2876 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2877 >-m FILE</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2878 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2879 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2880 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2881 >This will output a description of the link result to FILE.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2882 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2883 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2884 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2885 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2886 >--library=LIBSPEC</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2887 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2888 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2889 >-l LIBSPEC</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2890 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2891 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2892 ><P |
451 | 2893 >Load a library using the library search path. If LIBSPEC is prefixed with a |
2894 colon (":"), then LIBSPEC is the precise filename to be searched for in the | |
2895 library path. Otherwise, LIBSPEC will have "lib" prepended and ".a" appended.</P | |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2896 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2897 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2898 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2899 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2900 >--library-path=DIR</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2901 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2902 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2903 >-L DIR</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2904 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2905 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2906 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2907 >Add DIR to the library search path.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2908 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2909 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2910 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2911 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2912 >--debug</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2913 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2914 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2915 >-d</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2916 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2917 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2918 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2919 >This option increases the debugging level. It is only useful for LWTOOLS |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2920 developers.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2921 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2922 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2923 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2924 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2925 >--help</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2926 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2927 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2928 >-?</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2929 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2930 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2931 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2932 >This provides a listing of command line options and a brief description |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2933 of each.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2934 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2935 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2936 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2937 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2938 >--usage</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2939 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2940 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2941 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2942 >This will display a usage summary |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2943 of each command line option.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2944 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2945 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2946 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2947 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2948 >--version</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2949 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2950 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2951 >-V</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2952 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2953 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2954 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2955 >This will display the version of LWLINK.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2956 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2957 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2958 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2959 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2960 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2961 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2962 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2963 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2964 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
2965 NAME="AEN938" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2966 >4.2. Linker Operation</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2967 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2968 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2969 > LWLINK takes one or more files in supported input formats and links them |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2970 into a single binary. Currently supported formats are the LWTOOLS object |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2971 file format and the archive format used by LWAR. While the precise method is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2972 slightly different, linking can be conceptualized as the following steps. </P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2973 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2974 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2975 ><OL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2976 TYPE="1" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2977 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2978 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2979 >First, the linker loads a linking script. If no script is specified, it |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2980 loads a built-in default script based on the output format selected. This |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2981 script tells the linker how to lay out the various sections in the final |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2982 binary.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2983 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2984 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2985 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2986 >Next, the linker reads all the input files into memory. At this time, it |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2987 flags any format errors in those files. It constructs a table of symbols |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2988 for each object at this time.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2989 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2990 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2991 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2992 >The linker then proceeds with organizing the sections loaded from each file |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2993 according to the linking script. As it does so, it is able to assign addresses |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2994 to each symbol defined in each object file. At this time, the linker may |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2995 also collapse different instances of the same section name into a single |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2996 section by appending the data from each subsequent instance of the section |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2997 to the first instance of the section.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2998 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
2999 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3000 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3001 >Next, the linker looks through every object file for every incomplete reference. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3002 It then attempts to fully resolve that reference. If it cannot do so, it |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3003 throws an error. Once a reference is resolved, the value is placed into |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3004 the binary code at the specified section. It should be noted that an |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3005 incomplete reference can reference either a symbol internal to the object |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3006 file or an external symbol which is in the export list of another object |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3007 file.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3008 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3009 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3010 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3011 >If all of the above steps are successful, the linker opens the output file |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3012 and actually constructs the binary.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3013 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3014 ></OL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3015 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3016 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3017 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3018 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3019 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3020 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3021 NAME="AEN952" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3022 >4.3. Linking Scripts</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3023 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3024 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3025 >A linker script is used to instruct the linker about how to assemble the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3026 various sections into a completed binary. It consists of a series of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3027 directives which are considered in the order they are encountered.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3028 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3029 >The sections will appear in the resulting binary in the order they are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3030 specified in the script file. If a referenced section is not found, the linker will behave as though the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3031 section did exist but had a zero size, no relocations, and no exports. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3032 A section should only be referenced once. Any subsequent references will have |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3033 an undefined effect.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3034 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3035 >All numbers are in linking scripts are specified in hexadecimal. All directives |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3036 are case sensitive although the hexadecimal numbers are not.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3037 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3038 >A section name can be specified as a "*", then any section not |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3039 already matched by the script will be matched. The "*" can be followed |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3040 by a comma and a flag to narrow the section down slightly, also. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3041 If the flag is "!bss", then any section that is not flagged as a bss section |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3042 will be matched. If the flag is "bss", then any section that is flagged as |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3043 bss will be matched.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3044 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3045 >The following directives are understood in a linker script.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3046 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3047 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3048 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3049 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3050 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3051 ><DT |
236
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3052 >sectopt <CODE |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3053 CLASS="PARAMETER" |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3054 >section</CODE |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3055 > padafter <CODE |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3056 CLASS="PARAMETER" |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3057 >byte,...</CODE |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3058 ></DT |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3059 ><DD |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3060 ><P |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3061 > This will cause the linker to append the specified list of byte values |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3062 (specified in hexadecimal separated by commas) to the end of the named |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3063 section. This is done once all instances of the specified section are |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3064 collected together. This has no effect if the specified section does not |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3065 appear anywhere in any of the objects specified for linking. </P |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3066 ><P |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3067 > If code depends on the presence of this padding somewhere, it is sufficient |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3068 to include an empty section of the specified name in the object that depends |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3069 on it. </P |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3070 ></DD |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3071 ><DT |
234
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3072 >define basesympat <CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3073 CLASS="PARAMETER" |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3074 >string</CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3075 ></DT |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3076 ><DD |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3077 ><P |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3078 > This causes the linker to define a symbol for the ultimate base address of |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3079 each section using the pattern specified by <CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3080 CLASS="PARAMETER" |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3081 >string</CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3082 >. |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3083 In the string, %s can appear exactly once and will be replaced with the |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3084 section name. The base address is calculated after all instances of each |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3085 section have been collapsed together. </P |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3086 ><P |
236
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3087 > It should be noted that if none of the objects to be linked contains a |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3088 particular section name, there will be no base symbol defined for it, even |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3089 if it is listed explicitly in the link script. If code depends on the |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3090 presence of these symbols, it is sufficient to include an empty section of |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3091 the specified name in the object that depends on it. </P |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3092 ><P |
234
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3093 > If the pattern resolves to the same string for multiple |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3094 sections, the results are undefined. </P |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3095 ></DD |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3096 ><DT |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3097 >define lensympat <CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3098 CLASS="PARAMETER" |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3099 >string</CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3100 ></DT |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3101 ><DD |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3102 ><P |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3103 > This causes the linker to define a symbol for the ultimate length of each |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3104 section using the pattern specified by <CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3105 CLASS="PARAMETER" |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3106 >string</CODE |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3107 >. In |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3108 the string, %s can appear exactly once and will be replaced with the section |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3109 name. The length is calculated after all instances of a section have been |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3110 collapsed together. </P |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3111 ><P |
236
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3112 > It should be noted that if none of the objects to be linked contains a |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3113 particular section name, there will be no length symbol defined for it, even |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3114 if it is listed explicitly in the link script. If code depends on the |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3115 presence of these symbols, it is sufficient to include an empty section of |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3116 the specified name in the object that depends on it. </P |
ce1fdc8d6568
Added ability to add padding after a section when linking.
William Astle <lost@l-w.ca>
parents:
234
diff
changeset
|
3117 ><P |
234
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3118 >If the pattern resolves to the same string for multiple |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3119 sections, the results are undefined. </P |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3120 ></DD |
d389adbcc4ab
Added section base and length symbols to lwlink
William Astle <lost@l-w.ca>
parents:
232
diff
changeset
|
3121 ><DT |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3122 >section <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3123 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3124 >name</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3125 > load <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3126 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3127 >addr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3128 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3129 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3130 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3131 > This causes the section <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3132 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3133 >name</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3134 > to load at |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3135 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3136 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3137 >addr</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3138 >. For the raw target, only one "load at" entry is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3139 allowed for non-bss sections and it must be the first one. For raw targets, |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3140 it affects the addresses the linker assigns to symbols but has no other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3141 affect on the output. bss sections may all have separate load addresses but |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3142 since they will not appear in the binary anyway, this is okay.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3143 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3144 >For the decb target, each "load" entry will cause a new "block" to be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3145 output to the binary which will contain the load address. It is legal for |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3146 sections to overlap in this manner - the linker assumes the loader will sort |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3147 everything out.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3148 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3149 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3150 >section <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3151 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3152 >name</CODE |
316
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3153 > high <CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3154 CLASS="PARAMETER" |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3155 >addr</CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3156 ></DT |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3157 ><DD |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3158 ><P |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3159 > This causes the section <CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3160 CLASS="PARAMETER" |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3161 >name</CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3162 > to load with its end |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3163 address just below <CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3164 CLASS="PARAMETER" |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3165 >addr</CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3166 >. Subsequent sections are |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3167 loaded at progressively lower addresses. This may lead to inefficient file |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3168 encoding for some targets. As of this writing, it will also almost |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3169 certainly do the wrong thing for a raw target. </P |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3170 ><P |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3171 > This is useful for aligning a block of code with high memory. As an |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3172 example, if the total size of a section is $100 bytes and a high address of |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3173 $FE00 is specified, the section will actually load at $FD00. </P |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3174 ></DD |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3175 ><DT |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3176 >section <CODE |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3177 CLASS="PARAMETER" |
c4853a54b4a1
Documented new "high" option for link scripts.
William Astle <lost@l-w.ca>
parents:
254
diff
changeset
|
3178 >name</CODE |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3179 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3180 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3181 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3182 > This will cause the section <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3183 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3184 >name</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3185 > to load after the previously listed |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3186 section.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3187 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3188 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3189 >entry <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3190 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3191 >addr or sym</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3192 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3193 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3194 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3195 >This will cause the execution address (entry point) to be the address |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3196 specified (in hex) or the specified symbol name. The symbol name must |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3197 match a symbol that is exported by one of the object files being linked. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3198 This has no effect for targets that do not encode the entry point into the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3199 resulting file. If not specified, the entry point is assumed to be address 0 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3200 which is probably not what you want. The default link scripts for targets |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3201 that support this directive automatically starts at the beginning of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3202 first section (usually "init" or "code") that is emitted in the binary.</P |
533
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
518
diff
changeset
|
3203 ><P |
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
518
diff
changeset
|
3204 >Note that if you use a numeric value here, you will need to ensure |
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
518
diff
changeset
|
3205 it starts with a digit. That may mean adding a leading zero.</P |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3206 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3207 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3208 >pad <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3209 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3210 >size</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3211 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3212 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3213 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3214 >This will cause the output file to be padded with NUL bytes to be exactly |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3215 <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3216 CLASS="PARAMETER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3217 >size</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3218 > bytes in length. This only makes sense for a raw target.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3219 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3220 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3221 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3222 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3223 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3224 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3225 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3226 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3227 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3228 NAME="AEN1019" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3229 >4.4. Format Specific Linking Notes</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3230 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3231 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3232 >Some formats require special information to be able to generate actual |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3233 binaries. If the specific format you are interested in is not listed in |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3234 this section, then there is nothing special you need to know about to create |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3235 a final binary.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3236 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3237 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3238 ><HR><H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3239 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3240 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3241 NAME="AEN1022" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3242 >4.4.1. OS9 Modules</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3243 ></H3 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3244 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3245 >OS9 modules need to embed several items into the module header. These |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3246 items are the type of module, the langauge of the module, the module |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3247 attributes, the module revision number, the data size (bss), and the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3248 execution offset. These are all either calculated or default to reasonable |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3249 values.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3250 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3251 >The data size is calcuated as the sum of all sections named "bss" or |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3252 ".bss" in all object files that are linked together.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3253 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3254 >The execution offset is calculated from the address of the special |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3255 symbol "__start" which must be an exported (external) symbol in one of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3256 objects to be linked.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3257 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3258 >The type defaults to "Prgrm" or "Program module". The language |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3259 defaults to "Objct" or "6809 object code". Attributes default to enabling |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3260 the re-entrant flag. And finally, the revision defaults to zero.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3261 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3262 >The embedded module name is the output filename. If the output |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3263 filename includes more than just the filename, this will probably not be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3264 what you want.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3265 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3266 >The type, language, attributes, revision, and module name can all be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3267 overridden by providing a special section in exactly one of the object files |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3268 to be linked. This section is called "__os9" (note the two underscores). |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3269 To override the type, language, attributes, or revision values, define a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3270 non-exported symbol in this section called "type", "lang", "attr", or "rev" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3271 respectively. Any other symbols defined are ignored. To override the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3272 module name, include as the only actual code in the section a NUL terminated |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3273 string (the FCN directive is useful for this). If there is no code in the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3274 section or it beings with a NUL, the default name will be used. Any of the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3275 preceeding that are not defined in the special section will retain their |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3276 default values.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3277 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3278 >The built-in link script for OS9 modules will place the following |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3279 sections, in order, in the module: "code", ".text", "data", ".data". It |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3280 will merge all sections with the name "bss" or ".bss" into the "data" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3281 section. All other section names are ignored. What this means is that you |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3282 must define your data variables in the a section called "bss" or ".bss" even |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3283 though you will be refencing them all as offsets from U. This does have the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3284 unpleasant side effect that all BSS references will end up being 16 bit |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3285 offsets because the assembler cannot know what the offset will be once the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3286 linker is finished its work. Thus, if the tightest possible code is |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3287 required, having LWASM directly output the module is a better choice.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3288 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3289 >While the built-in link script is probably sufficient for most |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3290 purposes, you can provide your own script. If you provide a custom link |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3291 script, you must start your code and data sections at location 000D to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3292 accommodate the module header. Otherwise, you will have an incorrect |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3293 location for the execution offset. You must use the ENTRY directive in the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3294 script to define the entry point for the module.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3295 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3296 >It should also be obvious from the above that you cannot mix the bss |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3297 (rmb) definitions with the module code when linking separately. Those |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3298 familiar with typical module creation will probably find this an unpleasant |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3299 difference but it is unavoidable.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3300 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3301 >It should also be noted that direct page references should also be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3302 avoided because you cannot know ahead of time whether the linker is going to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3303 end up putting a particular variable in the first 256 bytes of the module's |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3304 data space. If, however, you know for certain you will have less than 256 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3305 bytes of defined data space across all of the object files that will be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3306 linked, you can instead use forced DP addressing for your data addresses |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3307 instead of the ,u notation. When linking with 3rd party libraries, this |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3308 practice should be avoided. Also, when creating libraries, always use the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3309 offset from U technique.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3310 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3311 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3312 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3313 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3314 CLASS="CHAPTER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3315 ><HR><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3316 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3317 NAME="AEN1034" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3318 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3319 >Chapter 5. Libraries and LWAR</H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3320 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3321 >LWTOOLS also includes a tool for managing libraries. These are analogous to |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3322 the static libraries created with the "ar" tool on POSIX systems. Each library |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3323 file contains one or more object files. The linker will treat the object |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3324 files within a library as though they had been specified individually on |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3325 the command line except when resolving external references. External references |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3326 are looked up first within the object files within the library and then, if |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3327 not found, the usual lookup based on the order the files are specified on |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3328 the command line occurs.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3329 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3330 >The tool for creating these libary files is called LWAR.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3331 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3332 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3333 ><HR><H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3334 CLASS="SECTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3335 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3336 NAME="AEN1038" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3337 >5.1. Command Line Options</A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3338 ></H2 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3339 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3340 >The binary for LWAR is called "lwar". Note that the binary is in lower |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3341 case. The options lwar understands are listed below. For archive manipulation |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3342 options, the first non-option argument is the name of the archive. All other |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3343 non-option arguments are the names of files to operate on.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3344 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3345 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3346 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3347 CLASS="VARIABLELIST" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3348 ><DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3349 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3350 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3351 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3352 >--add</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3353 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3354 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3355 >-a</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3356 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3357 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3358 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3359 >This option specifies that an archive is going to have files added to it. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3360 If the archive does not already exist, it is created. New files are added |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3361 to the end of the archive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3362 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3363 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3364 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3365 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3366 >--create</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3367 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3368 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3369 >-c</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3370 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3371 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3372 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3373 >This option specifies that an archive is going to be created and have files |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3374 added to it. If the archive already exists, it is truncated.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3375 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3376 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3377 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3378 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3379 >--merge</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3380 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3381 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3382 >-m</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3383 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3384 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3385 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3386 >If specified, any files specified to be added to an archive will be checked |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3387 to see if they are archives themselves. If so, their constituent members are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3388 added to the archive. This is useful for avoiding archives containing archives.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3389 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3390 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3391 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3392 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3393 >--list</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3394 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3395 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3396 >-l</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3397 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3398 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3399 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3400 >This will display a list of the files contained in the archive.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3401 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3402 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3403 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3404 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3405 >--debug</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3406 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3407 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3408 >-d</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3409 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3410 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3411 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3412 >This option increases the debugging level. It is only useful for LWTOOLS |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3413 developers.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3414 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3415 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3416 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3417 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3418 >--help</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3419 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3420 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3421 >-?</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3422 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3423 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3424 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3425 >This provides a listing of command line options and a brief description |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3426 of each.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3427 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3428 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3429 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3430 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3431 >--usage</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3432 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3433 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3434 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3435 >This will display a usage summary |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3436 of each command line option.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3437 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3438 ><DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3439 ><CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3440 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3441 >--version</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3442 >, <CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3443 CLASS="OPTION" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3444 >-V</CODE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3445 ></DT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3446 ><DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3447 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3448 >This will display the version of LWLINK. |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3449 of each.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3450 ></DD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3451 ></DL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3452 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3453 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3454 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3455 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3456 CLASS="CHAPTER" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3457 ><HR><H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3458 ><A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3459 NAME="OBJCHAP" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3460 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3461 >Chapter 6. Object Files</H1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3462 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3463 >LWTOOLS uses a proprietary object file format. It is proprietary in the sense |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3464 that it is specific to LWTOOLS, not that it is a hidden format. It would be |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3465 hard to keep it hidden in an open source tool chain anyway. This chapter |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3466 documents the object file format.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3467 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3468 >An object file consists of a series of sections each of which contains a |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3469 list of exported symbols, a list of incomplete references, and a list of |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3470 "local" symbols which may be used in calculating incomplete references. Each |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3471 section will obviously also contain the object code.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3472 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3473 >Exported symbols must be completely resolved to an address within the |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3474 section it is exported from. That is, an exported symbol must be a constant |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3475 rather than defined in terms of other symbols.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3476 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3477 >Each object file starts with a magic number and version number. The magic |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3478 number is the string "LWOBJ16" for this 16 bit object file format. The only |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3479 defined version number is currently 0. Thus, the first 8 bytes of the object |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3480 file are <FONT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3481 COLOR="RED" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3482 >4C574F424A313600</FONT |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3483 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3484 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3485 >Each section has the following items in order:</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3486 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3487 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3488 ><UL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3489 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3490 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3491 >section name</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3492 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3493 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3494 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3495 >flags</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3496 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3497 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3498 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3499 >list of local symbols (and addresses within the section)</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3500 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3501 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3502 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3503 >list of exported symbols (and addresses within the section)</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3504 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3505 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3506 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3507 >list of incomplete references along with the expressions to calculate them</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3508 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3509 ><LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3510 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3511 >the actual object code (for non-BSS sections)</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3512 ></LI |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3513 ></UL |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3514 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3515 >The section starts with the name of the section with a NUL termination |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3516 followed by a series of flag bytes terminated by NUL. There are only two |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3517 flag bytes defined. A NUL (0) indicates no more flags and a value of 1 |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3518 indicates the section is a BSS section. For a BSS section, no actual |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3519 code is included in the object file.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3520 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3521 >Either a NULL section name or end of file indicate the presence of no more |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3522 sections.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3523 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3524 >Each entry in the exported and local symbols table consists of the symbol |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3525 (NUL terminated) followed by two bytes which contain the value in big endian |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3526 order. The end of a symbol table is indicated by a NULL symbol name.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3527 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3528 >Each entry in the incomplete references table consists of an expression |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3529 followed by a 16 bit offset where the reference goes. Expressions are |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3530 defined as a series of terms up to an "end of expression" term. Each term |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3531 consists of a single byte which identifies the type of term (see below) |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3532 followed by any data required by the term. Then end of the list is flagged |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3533 by a NULL expression (only an end of expression term).</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3534 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3535 CLASS="TABLE" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3536 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3537 NAME="AEN1121" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3538 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3539 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3540 ><B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3541 >Table 6-1. Object File Term Types</B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3542 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3543 ><TABLE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3544 BORDER="1" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3545 FRAME="border" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3546 CLASS="CALSTABLE" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3547 ><COL><COL><THEAD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3548 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3549 ><TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3550 >TERMTYPE</TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3551 ><TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3552 >Meaning</TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3553 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3554 ></THEAD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3555 ><TBODY |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3556 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3557 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3558 >00</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3559 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3560 >end of expression</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3561 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3562 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3563 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3564 >01</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3565 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3566 >integer (16 bit in big endian order follows)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3567 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3568 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3569 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3570 >02</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3571 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3572 > external symbol reference (NUL terminated symbol name follows)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3573 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3574 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3575 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3576 >03</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3577 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3578 >local symbol reference (NUL terminated symbol name follows)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3579 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3580 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3581 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3582 >04</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3583 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3584 >operator (1 byte operator number)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3585 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3586 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3587 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3588 >05</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3589 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3590 >section base address reference</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3591 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3592 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3593 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3594 >FF</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3595 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3596 >This term will set flags for the expression. Each one of these terms will set a single flag. All of them should be specified first in an expression. If they are not, the behaviour is undefined. The byte following is the flag. Flag 01 indicates an 8 bit relocation. Flag 02 indicates a zero-width relocation (see the EXTDEP pseudo op in LWASM).</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3597 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3598 ></TBODY |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3599 ></TABLE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3600 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3601 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3602 >External references are resolved using other object files while local |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3603 references are resolved using the local symbol table(s) from this file. This |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3604 allows local symbols that are not exported to have the same names as |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3605 exported symbols or external references.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3606 ><DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3607 CLASS="TABLE" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3608 ><A |
565
fc072f6cde09
Update documentation to reflect includebin offset/length feature
William Astle <lost@l-w.ca>
parents:
563
diff
changeset
|
3609 NAME="AEN1151" |
153
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3610 ></A |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3611 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3612 ><B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3613 >Table 6-2. Object File Operator Numbers</B |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3614 ></P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3615 ><TABLE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3616 BORDER="1" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3617 FRAME="border" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3618 CLASS="CALSTABLE" |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3619 ><COL><COL><THEAD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3620 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3621 ><TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3622 >Number</TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3623 ><TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3624 >Operator</TH |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3625 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3626 ></THEAD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3627 ><TBODY |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3628 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3629 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3630 >01</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3631 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3632 >addition (+)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3633 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3634 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3635 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3636 >02</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3637 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3638 >subtraction (-)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3639 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3640 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3641 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3642 >03</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3643 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3644 >multiplication (*)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3645 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3646 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3647 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3648 >04</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3649 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3650 >division (/)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3651 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3652 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3653 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3654 >05</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3655 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3656 >modulus (%)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3657 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3658 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3659 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3660 >06</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3661 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3662 >integer division (\) (same as division)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3663 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3664 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3665 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3666 >07</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3667 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3668 >bitwise and</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3669 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3670 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3671 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3672 >08</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3673 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3674 >bitwise or</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3675 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3676 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3677 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3678 >09</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3679 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3680 >bitwise xor</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3681 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3682 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3683 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3684 >0A</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3685 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3686 >boolean and</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3687 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3688 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3689 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3690 >0B</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3691 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3692 >boolean or</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3693 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3694 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3695 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3696 >0C</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3697 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3698 >unary negation, 2's complement (-)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3699 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3700 ><TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3701 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3702 >0D</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3703 ><TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3704 >unary 1's complement (^)</TD |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3705 ></TR |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3706 ></TBODY |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3707 ></TABLE |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3708 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3709 ><P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3710 >An expression is represented in a postfix manner with both operands for |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3711 binary operators preceding the operator and the single operand for unary |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3712 operators preceding the operator.</P |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3713 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3714 ></DIV |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3715 ></BODY |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3716 ></HTML |
83b7b4ce3bbd
Added prebuilt manual to repository to avoid failures to include it during releases
lost@l-w.ca
parents:
diff
changeset
|
3717 > |