Mercurial > hg > index.cgi

annotate docs/manual/x554.html @ 389:2d9b7ae6c329

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Throw error if address overflows in extended mode This may or may not cause extra problems due to sloppiness in dealing with calculations that overflow in 16 bits. However, presumably it is a good idea so unless something major pops up, it seems like a good idea. Thanks to Erik G <erik@6809.org> for the patch.
author William Astle <lost@l-w.ca>
date Mon, 13 Jul 2015 21:37:49 -0600
parents 682524a1f32f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
369
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <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">
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
2 <HTML
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
3 ><HEAD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
4 ><TITLE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
5 >Structures</TITLE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
6 ><META
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
7 NAME="GENERATOR"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
9 REL="HOME"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
10 TITLE="LW Tool Chain"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
11 HREF="index.html"><LINK
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
12 REL="UP"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
13 TITLE="LWASM"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
14 HREF="c62.html"><LINK
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
15 REL="PREVIOUS"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
16 TITLE="Macros"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
17 HREF="x531.html"><LINK
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
18 REL="NEXT"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
19 TITLE="Object Files and Sections"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
20 HREF="x575.html"></HEAD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
21 ><BODY
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
22 CLASS="SECTION"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
23 BGCOLOR="#FFFFFF"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
24 TEXT="#000000"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
25 LINK="#0000FF"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
26 VLINK="#840084"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
27 ALINK="#0000FF"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
28 ><DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
29 CLASS="NAVHEADER"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
30 ><TABLE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
31 SUMMARY="Header navigation table"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
32 WIDTH="100%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
33 BORDER="0"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
34 CELLPADDING="0"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
35 CELLSPACING="0"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
36 ><TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
37 ><TH
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
38 COLSPAN="3"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
39 ALIGN="center"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
40 >LW Tool Chain</TH
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
41 ></TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
42 ><TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
43 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
44 WIDTH="10%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
45 ALIGN="left"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
46 VALIGN="bottom"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
47 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
48 HREF="x531.html"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
49 ACCESSKEY="P"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
50 >Prev</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
51 ></TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
52 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
53 WIDTH="80%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
54 ALIGN="center"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
55 VALIGN="bottom"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
56 >Chapter 3. LWASM</TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
57 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
58 WIDTH="10%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
59 ALIGN="right"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
60 VALIGN="bottom"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
61 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
62 HREF="x575.html"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
63 ACCESSKEY="N"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
64 >Next</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
65 ></TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
66 ></TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
67 ></TABLE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
68 ><HR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
69 ALIGN="LEFT"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
70 WIDTH="100%"></DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
71 ><DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
72 CLASS="SECTION"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
73 ><H1
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
74 CLASS="SECTION"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
75 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
76 NAME="AEN554"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
77 >3.8. Structures</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
78 ></H1
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
79 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
80 >&#13;Structures are used to group related data in a fixed structure. A structure
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
81 consists a number of fields, defined in sequential order and which take up
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
82 specified size. The assembler does not enforce any means of access within a
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
83 structure; it assumes that whatever you are doing, you intended to do.
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
84 There are two pseudo ops that are used for defining structures.&#13;</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
85 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
86 ></P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
87 ><DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
88 CLASS="VARIABLELIST"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
89 ><DL
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
90 ><DT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
91 ><CODE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
92 CLASS="PARAMETER"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
93 >structname</CODE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
94 > STRUCT</DT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
95 ><DD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
96 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
97 >&#13;This directive is used to begin the definition of a structure with name
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
98 <CODE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
99 CLASS="PARAMETER"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
100 >structname</CODE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
101 >. Subsequent statements all form part of
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
102 the structure definition until the end of the structure is declared.&#13;</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
103 ></DD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
104 ><DT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
105 >ENDSTRUCT, ENDS</DT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
106 ><DD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
107 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
108 >This directive ends the definition of the structure. ENDSTRUCT is the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
109 preferred form. Prior to version 3.0 of LWASM, ENDS was used to end a
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
110 section instead of a structure.</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
111 ></DD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
112 ></DL
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
113 ></DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
114 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
115 >&#13;Within a structure definition, only reservation pseudo ops are permitted.
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
116 Anything else will cause an assembly error.</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
117 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
118 > Once a structure is defined, you can reserve an area of memory in the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
119 same structure by using the structure name as the opcode. Structures can
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
120 also contain fields that are themselves structures. See the example
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
121 below.</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
122 ><PRE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
123 CLASS="PROGRAMLISTING"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
124 >tstruct2 STRUCT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
125 f1 rmb 1
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
126 f2 rmb 1
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
127 ENDSTRUCT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
128
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
129 tstruct STRUCT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
130 field1 rmb 2
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
131 field2 rmb 3
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
132 field3 tstruct2
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
133 ENDSTRUCT
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
134
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
135 ORG $2000
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
136 var1 tstruct
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
137 var2 tstruct2</PRE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
138 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
139 >Fields are referenced using a dot (.) as a separator. To refer to the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
140 generic offset within a structure, use the structure name to the left of the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
141 dot. If referring to a field within an actual variable, use the variable's
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
142 symbol name to the left of the dot.</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
143 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
144 >You can also refer to the actual size of a structure (or a variable
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
145 declared as a structure) using the special symbol sizeof{structname} where
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
146 structname will be the name of the structure or the name of the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
147 variable.</P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
148 ><P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
149 >Essentially, structures are a shortcut for defining a vast number of
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
150 symbols. When a structure is defined, the assembler creates symbols for the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
151 various fields in the form structname.fieldname as well as the appropriate
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
152 sizeof{structname} symbol. When a variable is declared as a structure, the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
153 assembler does the same thing using the name of the variable. You will see
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
154 these symbols in the symbol table when the assembler is instructed to
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
155 provide a listing. For instance, the above listing will create the
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
156 following symbols (symbol values in parentheses): tstruct2.f1 (0),
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
157 tstruct2.f2 (1), sizeof{tstruct2} (2), tstruct.field1 (0), tstruct.field2
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
158 (2), tstruct.field3 (5), tstruct.field3.f1 (5), tstruct.field3.f2 (6),
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
159 sizeof{tstruct.field3} (2), sizeof{tstruct} (7), var1 {$2000}, var1.field1
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
160 {$2000}, var1.field2 {$2002}, var1.field3 {$2005}, var1.field3.f1 {$2005},
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
161 var1.field3.f2 {$2006}, sizeof(var1.field3} (2), sizeof{var1} (7), var2
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
162 ($2007), var2.f1 ($2007), var2.f2 ($2008), sizeof{var2} (2). </P
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
163 ></DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
164 ><DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
165 CLASS="NAVFOOTER"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
166 ><HR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
167 ALIGN="LEFT"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
168 WIDTH="100%"><TABLE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
169 SUMMARY="Footer navigation table"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
170 WIDTH="100%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
171 BORDER="0"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
172 CELLPADDING="0"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
173 CELLSPACING="0"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
174 ><TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
175 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
176 WIDTH="33%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
177 ALIGN="left"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
178 VALIGN="top"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
179 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
180 HREF="x531.html"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
181 ACCESSKEY="P"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
182 >Prev</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
183 ></TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
184 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
185 WIDTH="34%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
186 ALIGN="center"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
187 VALIGN="top"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
188 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
189 HREF="index.html"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
190 ACCESSKEY="H"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
191 >Home</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
192 ></TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
193 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
194 WIDTH="33%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
195 ALIGN="right"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
196 VALIGN="top"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
197 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
198 HREF="x575.html"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
199 ACCESSKEY="N"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
200 >Next</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
201 ></TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
202 ></TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
203 ><TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
204 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
205 WIDTH="33%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
206 ALIGN="left"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
207 VALIGN="top"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
208 >Macros</TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
209 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
210 WIDTH="34%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
211 ALIGN="center"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
212 VALIGN="top"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
213 ><A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
214 HREF="c62.html"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
215 ACCESSKEY="U"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
216 >Up</A
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
217 ></TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
218 ><TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
219 WIDTH="33%"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
220 ALIGN="right"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
221 VALIGN="top"
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
222 >Object Files and Sections</TD
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
223 ></TR
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
224 ></TABLE
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
225 ></DIV
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
226 ></BODY
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
227 ></HTML
682524a1f32f Updated documentation for --symbols-nolocals and --map
William Astle <lost@l-w.ca>
parents:
diff changeset
228 >