Mercurial > hg > index.cgi
comparison docs/manual/manual.html @ 489:52af0aa54fe5
Update html and pdf documentation in preparation for release
author | William Astle <lost@l-w.ca> |
---|---|
date | Fri, 03 May 2019 20:06:17 -0600 |
parents | a71206ed966c |
children | 1faf14de9d04 |
comparison
equal
deleted
inserted
replaced
488:94bbdb2890b7 | 489:52af0aa54fe5 |
---|---|
119 HREF="#AEN65" | 119 HREF="#AEN65" |
120 >Command Line Options</A | 120 >Command Line Options</A |
121 ></DT | 121 ></DT |
122 ><DT | 122 ><DT |
123 >3.2. <A | 123 >3.2. <A |
124 HREF="#AEN218" | 124 HREF="#AEN229" |
125 >Dialects</A | 125 >Dialects</A |
126 ></DT | 126 ></DT |
127 ><DT | 127 ><DT |
128 >3.3. <A | 128 >3.3. <A |
129 HREF="#AEN227" | 129 HREF="#AEN238" |
130 >Source Format</A | 130 >Source Format</A |
131 ></DT | 131 ></DT |
132 ><DT | 132 ><DT |
133 >3.4. <A | 133 >3.4. <A |
134 HREF="#AEN237" | 134 HREF="#AEN248" |
135 >Symbols</A | 135 >Symbols</A |
136 ></DT | 136 ></DT |
137 ><DT | 137 ><DT |
138 >3.5. <A | 138 >3.5. <A |
139 HREF="#AEN242" | 139 HREF="#AEN253" |
140 >Numbers and Expressions</A | 140 >Numbers and Expressions</A |
141 ></DT | 141 ></DT |
142 ><DT | 142 ><DT |
143 >3.6. <A | 143 >3.6. <A |
144 HREF="#AEN250" | 144 HREF="#AEN261" |
145 >Assembler Directives</A | 145 >Assembler Directives</A |
146 ></DT | 146 ></DT |
147 ><DD | 147 ><DD |
148 ><DL | 148 ><DL |
149 ><DT | 149 ><DT |
150 >3.6.1. <A | 150 >3.6.1. <A |
151 HREF="#AEN253" | 151 HREF="#AEN264" |
152 >Data Directives</A | 152 >Data Directives</A |
153 ></DT | 153 ></DT |
154 ><DT | 154 ><DT |
155 >3.6.2. <A | 155 >3.6.2. <A |
156 HREF="#AEN364" | 156 HREF="#AEN375" |
157 >Address Definition</A | 157 >Address Definition</A |
158 ></DT | 158 ></DT |
159 ><DT | 159 ><DT |
160 >3.6.3. <A | 160 >3.6.3. <A |
161 HREF="#AEN415" | 161 HREF="#AEN426" |
162 >Conditional Assembly</A | 162 >Conditional Assembly</A |
163 ></DT | 163 ></DT |
164 ><DT | 164 ><DT |
165 >3.6.4. <A | 165 >3.6.4. <A |
166 HREF="#AEN486" | 166 HREF="#AEN497" |
167 >OS9 Target Directives</A | 167 >OS9 Target Directives</A |
168 ></DT | 168 ></DT |
169 ><DT | 169 ><DT |
170 >3.6.5. <A | 170 >3.6.5. <A |
171 HREF="#AEN511" | 171 HREF="#AEN522" |
172 >Miscelaneous Directives</A | 172 >Miscelaneous Directives</A |
173 ></DT | 173 ></DT |
174 ></DL | 174 ></DL |
175 ></DD | 175 ></DD |
176 ><DT | 176 ><DT |
177 >3.7. <A | 177 >3.7. <A |
178 HREF="#AEN551" | 178 HREF="#AEN562" |
179 >Macros</A | 179 >Macros</A |
180 ></DT | 180 ></DT |
181 ><DT | 181 ><DT |
182 >3.8. <A | 182 >3.8. <A |
183 HREF="#AEN574" | 183 HREF="#AEN585" |
184 >Structures</A | 184 >Structures</A |
185 ></DT | 185 ></DT |
186 ><DT | 186 ><DT |
187 >3.9. <A | 187 >3.9. <A |
188 HREF="#AEN595" | 188 HREF="#AEN606" |
189 >Object Files and Sections</A | 189 >Object Files and Sections</A |
190 ></DT | 190 ></DT |
191 ><DT | 191 ><DT |
192 >3.10. <A | 192 >3.10. <A |
193 HREF="#AEN659" | 193 HREF="#AEN670" |
194 >Assembler Modes and Pragmas</A | 194 >Assembler Modes and Pragmas</A |
195 ></DT | 195 ></DT |
196 ><DT | 196 ><DT |
197 >3.11. <A | 197 >3.11. <A |
198 HREF="#CONVINST" | 198 HREF="#CONVINST" |
199 >Convenience Instructions</A | 199 >Convenience Instructions</A |
200 ></DT | 200 ></DT |
201 ><DT | 201 ><DT |
202 >3.12. <A | 202 >3.12. <A |
203 HREF="#AEN810" | 203 HREF="#AEN821" |
204 >Cycle Counts</A | 204 >Cycle Counts</A |
205 ></DT | 205 ></DT |
206 ></DL | 206 ></DL |
207 ></DD | 207 ></DD |
208 ><DT | 208 ><DT |
209 >4. <A | 209 >4. <A |
210 HREF="#AEN816" | 210 HREF="#AEN827" |
211 >LWLINK</A | 211 >LWLINK</A |
212 ></DT | 212 ></DT |
213 ><DD | 213 ><DD |
214 ><DL | 214 ><DL |
215 ><DT | 215 ><DT |
216 >4.1. <A | 216 >4.1. <A |
217 HREF="#AEN819" | 217 HREF="#AEN830" |
218 >Command Line Options</A | 218 >Command Line Options</A |
219 ></DT | 219 ></DT |
220 ><DT | 220 ><DT |
221 >4.2. <A | 221 >4.2. <A |
222 HREF="#AEN916" | 222 HREF="#AEN927" |
223 >Linker Operation</A | 223 >Linker Operation</A |
224 ></DT | 224 ></DT |
225 ><DT | 225 ><DT |
226 >4.3. <A | 226 >4.3. <A |
227 HREF="#AEN930" | 227 HREF="#AEN941" |
228 >Linking Scripts</A | 228 >Linking Scripts</A |
229 ></DT | 229 ></DT |
230 ><DT | 230 ><DT |
231 >4.4. <A | 231 >4.4. <A |
232 HREF="#AEN996" | 232 HREF="#AEN1007" |
233 >Format Specific Linking Notes</A | 233 >Format Specific Linking Notes</A |
234 ></DT | 234 ></DT |
235 ><DD | 235 ><DD |
236 ><DL | 236 ><DL |
237 ><DT | 237 ><DT |
238 >4.4.1. <A | 238 >4.4.1. <A |
239 HREF="#AEN999" | 239 HREF="#AEN1010" |
240 >OS9 Modules</A | 240 >OS9 Modules</A |
241 ></DT | 241 ></DT |
242 ></DL | 242 ></DL |
243 ></DD | 243 ></DD |
244 ></DL | 244 ></DL |
245 ></DD | 245 ></DD |
246 ><DT | 246 ><DT |
247 >5. <A | 247 >5. <A |
248 HREF="#AEN1011" | 248 HREF="#AEN1022" |
249 >Libraries and LWAR</A | 249 >Libraries and LWAR</A |
250 ></DT | 250 ></DT |
251 ><DD | 251 ><DD |
252 ><DL | 252 ><DL |
253 ><DT | 253 ><DT |
254 >5.1. <A | 254 >5.1. <A |
255 HREF="#AEN1015" | 255 HREF="#AEN1026" |
256 >Command Line Options</A | 256 >Command Line Options</A |
257 ></DT | 257 ></DT |
258 ></DL | 258 ></DL |
259 ></DD | 259 ></DD |
260 ><DT | 260 ><DT |
272 ><B | 272 ><B |
273 >List of Tables</B | 273 >List of Tables</B |
274 ></DT | 274 ></DT |
275 ><DT | 275 ><DT |
276 >6-1. <A | 276 >6-1. <A |
277 HREF="#AEN1098" | 277 HREF="#AEN1109" |
278 >Object File Term Types</A | 278 >Object File Term Types</A |
279 ></DT | 279 ></DT |
280 ><DT | 280 ><DT |
281 >6-2. <A | 281 >6-2. <A |
282 HREF="#AEN1128" | 282 HREF="#AEN1139" |
283 >Object File Operator Numbers</A | 283 >Object File Operator Numbers</A |
284 ></DT | 284 ></DT |
285 ></DL | 285 ></DL |
286 ></DIV | 286 ></DIV |
287 ><DIV | 287 ><DIV |
677 is specified, the list will not include the symbol table.</P | 677 is specified, the list will not include the symbol table.</P |
678 ></DD | 678 ></DD |
679 ><DT | 679 ><DT |
680 ><CODE | 680 ><CODE |
681 CLASS="OPTION" | 681 CLASS="OPTION" |
682 >--symbol-dump[=file]</CODE | |
683 ></DT | |
684 ><DD | |
685 ><P | |
686 >Cause LWASM to output the global symbol table in assembly source format. If | |
687 <CODE | |
688 CLASS="OPTION" | |
689 >file</CODE | |
690 > is specified, the table output will go to the specified | |
691 file. Otherwise, it will go to the standard output stream. Local symbols will | |
692 not be included. Incomplete symbols will be defined to zero with a comment | |
693 indicating incompleteness. Symbols defined with SET will also be listed using | |
694 SET in the symbol dump. However, if the symbol is defined multiple times, the | |
695 order of the definitions in the dump file is undefined.</P | |
696 ></DD | |
697 ><DT | |
698 ><CODE | |
699 CLASS="OPTION" | |
682 >--symbols</CODE | 700 >--symbols</CODE |
683 >, <CODE | 701 >, <CODE |
684 CLASS="OPTION" | 702 CLASS="OPTION" |
685 >-s</CODE | 703 >-s</CODE |
686 ></DT | 704 ></DT |
732 >This option specifies the name of the output file. If not specified, the | 750 >This option specifies the name of the output file. If not specified, the |
733 default is <CODE | 751 default is <CODE |
734 CLASS="OPTION" | 752 CLASS="OPTION" |
735 >a.out</CODE | 753 >a.out</CODE |
736 >.</P | 754 >.</P |
755 ></DD | |
756 ><DT | |
757 ><CODE | |
758 CLASS="OPTION" | |
759 >--no-output</CODE | |
760 ></DT | |
761 ><DD | |
762 ><P | |
763 >Do assembly as usual but suppress generation of the output file.</P | |
737 ></DD | 764 ></DD |
738 ><DT | 765 ><DT |
739 ><CODE | 766 ><CODE |
740 CLASS="OPTION" | 767 CLASS="OPTION" |
741 >--pragma=pragma</CODE | 768 >--pragma=pragma</CODE |
863 ><DIV | 890 ><DIV |
864 CLASS="SECTION" | 891 CLASS="SECTION" |
865 ><HR><H2 | 892 ><HR><H2 |
866 CLASS="SECTION" | 893 CLASS="SECTION" |
867 ><A | 894 ><A |
868 NAME="AEN218" | 895 NAME="AEN229" |
869 >3.2. Dialects</A | 896 >3.2. Dialects</A |
870 ></H2 | 897 ></H2 |
871 ><P | 898 ><P |
872 > LWASM supports all documented MC6809 instructions as defined by | 899 > LWASM supports all documented MC6809 instructions as defined by |
873 Motorola. By default, this does not include any MC6800 compatibility | 900 Motorola. By default, this does not include any MC6800 compatibility |
907 ><DIV | 934 ><DIV |
908 CLASS="SECTION" | 935 CLASS="SECTION" |
909 ><HR><H2 | 936 ><HR><H2 |
910 CLASS="SECTION" | 937 CLASS="SECTION" |
911 ><A | 938 ><A |
912 NAME="AEN227" | 939 NAME="AEN238" |
913 >3.3. Source Format</A | 940 >3.3. Source Format</A |
914 ></H2 | 941 ></H2 |
915 ><P | 942 ><P |
916 >LWASM accepts plain text files in a relatively free form. It can handle | 943 >LWASM accepts plain text files in a relatively free form. It can handle |
917 lines terminated with CR, LF, CRLF, or LFCR which means it should be able | 944 lines terminated with CR, LF, CRLF, or LFCR which means it should be able |
953 ><DIV | 980 ><DIV |
954 CLASS="SECTION" | 981 CLASS="SECTION" |
955 ><HR><H2 | 982 ><HR><H2 |
956 CLASS="SECTION" | 983 CLASS="SECTION" |
957 ><A | 984 ><A |
958 NAME="AEN237" | 985 NAME="AEN248" |
959 >3.4. Symbols</A | 986 >3.4. Symbols</A |
960 ></H2 | 987 ></H2 |
961 ><P | 988 ><P |
962 >Symbols have no length restriction. They may contain letters, numbers, dots, | 989 >Symbols have no length restriction. They may contain letters, numbers, dots, |
963 dollar signs, and underscores. They must start with a letter, dot, or | 990 dollar signs, and underscores. They must start with a letter, dot, or |
981 ><DIV | 1008 ><DIV |
982 CLASS="SECTION" | 1009 CLASS="SECTION" |
983 ><HR><H2 | 1010 ><HR><H2 |
984 CLASS="SECTION" | 1011 CLASS="SECTION" |
985 ><A | 1012 ><A |
986 NAME="AEN242" | 1013 NAME="AEN253" |
987 >3.5. Numbers and Expressions</A | 1014 >3.5. Numbers and Expressions</A |
988 ></H2 | 1015 ></H2 |
989 ><P | 1016 ><P |
990 > Numbers can be expressed in binary, octal, decimal, or hexadecimal. Binary | 1017 > Numbers can be expressed in binary, octal, decimal, or hexadecimal. Binary |
991 numbers may be prefixed with a "%" symbol or suffixed with a "b" or "B". | 1018 numbers may be prefixed with a "%" symbol or suffixed with a "b" or "B". |
1026 ><DIV | 1053 ><DIV |
1027 CLASS="SECTION" | 1054 CLASS="SECTION" |
1028 ><HR><H2 | 1055 ><HR><H2 |
1029 CLASS="SECTION" | 1056 CLASS="SECTION" |
1030 ><A | 1057 ><A |
1031 NAME="AEN250" | 1058 NAME="AEN261" |
1032 >3.6. Assembler Directives</A | 1059 >3.6. Assembler Directives</A |
1033 ></H2 | 1060 ></H2 |
1034 ><P | 1061 ><P |
1035 >Various directives can be used to control the behaviour of the | 1062 >Various directives can be used to control the behaviour of the |
1036 assembler or to include non-code/data in the resulting output. Those directives | 1063 assembler or to include non-code/data in the resulting output. Those directives |
1039 ><DIV | 1066 ><DIV |
1040 CLASS="SECTION" | 1067 CLASS="SECTION" |
1041 ><HR><H3 | 1068 ><HR><H3 |
1042 CLASS="SECTION" | 1069 CLASS="SECTION" |
1043 ><A | 1070 ><A |
1044 NAME="AEN253" | 1071 NAME="AEN264" |
1045 >3.6.1. Data Directives</A | 1072 >3.6.1. Data Directives</A |
1046 ></H3 | 1073 ></H3 |
1047 ><P | 1074 ><P |
1048 ></P | 1075 ></P |
1049 ><DIV | 1076 ><DIV |
1273 ><DIV | 1300 ><DIV |
1274 CLASS="SECTION" | 1301 CLASS="SECTION" |
1275 ><HR><H3 | 1302 ><HR><H3 |
1276 CLASS="SECTION" | 1303 CLASS="SECTION" |
1277 ><A | 1304 ><A |
1278 NAME="AEN364" | 1305 NAME="AEN375" |
1279 >3.6.2. Address Definition</A | 1306 >3.6.2. Address Definition</A |
1280 ></H3 | 1307 ></H3 |
1281 ><P | 1308 ><P |
1282 >The directives in this section all control the addresses of symbols | 1309 >The directives in this section all control the addresses of symbols |
1283 or the assembly process itself.</P | 1310 or the assembly process itself.</P |
1419 ><DIV | 1446 ><DIV |
1420 CLASS="SECTION" | 1447 CLASS="SECTION" |
1421 ><HR><H3 | 1448 ><HR><H3 |
1422 CLASS="SECTION" | 1449 CLASS="SECTION" |
1423 ><A | 1450 ><A |
1424 NAME="AEN415" | 1451 NAME="AEN426" |
1425 >3.6.3. Conditional Assembly</A | 1452 >3.6.3. Conditional Assembly</A |
1426 ></H3 | 1453 ></H3 |
1427 ><P | 1454 ><P |
1428 >Portions of the source code can be excluded or included based on conditions | 1455 >Portions of the source code can be excluded or included based on conditions |
1429 known at assembly time. Conditionals can be nested arbitrarily deeply. The | 1456 known at assembly time. Conditionals can be nested arbitrarily deeply. The |
1594 ><DIV | 1621 ><DIV |
1595 CLASS="SECTION" | 1622 CLASS="SECTION" |
1596 ><HR><H3 | 1623 ><HR><H3 |
1597 CLASS="SECTION" | 1624 CLASS="SECTION" |
1598 ><A | 1625 ><A |
1599 NAME="AEN486" | 1626 NAME="AEN497" |
1600 >3.6.4. OS9 Target Directives</A | 1627 >3.6.4. OS9 Target Directives</A |
1601 ></H3 | 1628 ></H3 |
1602 ><P | 1629 ><P |
1603 >This section includes directives that apply solely to the OS9 | 1630 >This section includes directives that apply solely to the OS9 |
1604 target.</P | 1631 target.</P |
1661 ><DIV | 1688 ><DIV |
1662 CLASS="SECTION" | 1689 CLASS="SECTION" |
1663 ><HR><H3 | 1690 ><HR><H3 |
1664 CLASS="SECTION" | 1691 CLASS="SECTION" |
1665 ><A | 1692 ><A |
1666 NAME="AEN511" | 1693 NAME="AEN522" |
1667 >3.6.5. Miscelaneous Directives</A | 1694 >3.6.5. Miscelaneous Directives</A |
1668 ></H3 | 1695 ></H3 |
1669 ><P | 1696 ><P |
1670 >This section includes directives that do not fit into the other | 1697 >This section includes directives that do not fit into the other |
1671 categories.</P | 1698 categories.</P |
1775 ><DIV | 1802 ><DIV |
1776 CLASS="SECTION" | 1803 CLASS="SECTION" |
1777 ><HR><H2 | 1804 ><HR><H2 |
1778 CLASS="SECTION" | 1805 CLASS="SECTION" |
1779 ><A | 1806 ><A |
1780 NAME="AEN551" | 1807 NAME="AEN562" |
1781 >3.7. Macros</A | 1808 >3.7. Macros</A |
1782 ></H2 | 1809 ></H2 |
1783 ><P | 1810 ><P |
1784 >LWASM is a macro assembler. A macro is simply a name that stands in for a | 1811 >LWASM is a macro assembler. A macro is simply a name that stands in for a |
1785 series of instructions. Once a macro is defined, it is used like any other | 1812 series of instructions. Once a macro is defined, it is used like any other |
1874 ><DIV | 1901 ><DIV |
1875 CLASS="SECTION" | 1902 CLASS="SECTION" |
1876 ><HR><H2 | 1903 ><HR><H2 |
1877 CLASS="SECTION" | 1904 CLASS="SECTION" |
1878 ><A | 1905 ><A |
1879 NAME="AEN574" | 1906 NAME="AEN585" |
1880 >3.8. Structures</A | 1907 >3.8. Structures</A |
1881 ></H2 | 1908 ></H2 |
1882 ><P | 1909 ><P |
1883 > Structures are used to group related data in a fixed structure. A structure | 1910 > Structures are used to group related data in a fixed structure. A structure |
1884 consists a number of fields, defined in sequential order and which take up | 1911 consists a number of fields, defined in sequential order and which take up |
1967 ><DIV | 1994 ><DIV |
1968 CLASS="SECTION" | 1995 CLASS="SECTION" |
1969 ><HR><H2 | 1996 ><HR><H2 |
1970 CLASS="SECTION" | 1997 CLASS="SECTION" |
1971 ><A | 1998 ><A |
1972 NAME="AEN595" | 1999 NAME="AEN606" |
1973 >3.9. Object Files and Sections</A | 2000 >3.9. Object Files and Sections</A |
1974 ></H2 | 2001 ></H2 |
1975 ><P | 2002 ><P |
1976 >The object file target is very useful for large project because it allows | 2003 >The object file target is very useful for large project because it allows |
1977 multiple files to be assembled independently and then linked into the final | 2004 multiple files to be assembled independently and then linked into the final |
2184 ><DIV | 2211 ><DIV |
2185 CLASS="SECTION" | 2212 CLASS="SECTION" |
2186 ><HR><H2 | 2213 ><HR><H2 |
2187 CLASS="SECTION" | 2214 CLASS="SECTION" |
2188 ><A | 2215 ><A |
2189 NAME="AEN659" | 2216 NAME="AEN670" |
2190 >3.10. Assembler Modes and Pragmas</A | 2217 >3.10. Assembler Modes and Pragmas</A |
2191 ></H2 | 2218 ></H2 |
2192 ><P | 2219 ><P |
2193 >There are a number of options that affect the way assembly is performed. | 2220 >There are a number of options that affect the way assembly is performed. |
2194 Some of these options can only be specified on the command line because | 2221 Some of these options can only be specified on the command line because |
2649 ><DIV | 2676 ><DIV |
2650 CLASS="SECTION" | 2677 CLASS="SECTION" |
2651 ><HR><H2 | 2678 ><HR><H2 |
2652 CLASS="SECTION" | 2679 CLASS="SECTION" |
2653 ><A | 2680 ><A |
2654 NAME="AEN810" | 2681 NAME="AEN821" |
2655 >3.12. Cycle Counts</A | 2682 >3.12. Cycle Counts</A |
2656 ></H2 | 2683 ></H2 |
2657 ><P | 2684 ><P |
2658 > The following options for displaying cycle counts in listings are provided. | 2685 > The following options for displaying cycle counts in listings are provided. |
2659 These options are enabled from pragmas on the command line or in the | 2686 These options are enabled from pragmas on the command line or in the |
2688 ></DIV | 2715 ></DIV |
2689 ><DIV | 2716 ><DIV |
2690 CLASS="CHAPTER" | 2717 CLASS="CHAPTER" |
2691 ><HR><H1 | 2718 ><HR><H1 |
2692 ><A | 2719 ><A |
2693 NAME="AEN816" | 2720 NAME="AEN827" |
2694 ></A | 2721 ></A |
2695 >Chapter 4. LWLINK</H1 | 2722 >Chapter 4. LWLINK</H1 |
2696 ><P | 2723 ><P |
2697 >The LWTOOLS linker is called LWLINK. This chapter documents the various features | 2724 >The LWTOOLS linker is called LWLINK. This chapter documents the various features |
2698 of the linker.</P | 2725 of the linker.</P |
2699 ><DIV | 2726 ><DIV |
2700 CLASS="SECTION" | 2727 CLASS="SECTION" |
2701 ><HR><H2 | 2728 ><HR><H2 |
2702 CLASS="SECTION" | 2729 CLASS="SECTION" |
2703 ><A | 2730 ><A |
2704 NAME="AEN819" | 2731 NAME="AEN830" |
2705 >4.1. Command Line Options</A | 2732 >4.1. Command Line Options</A |
2706 ></H2 | 2733 ></H2 |
2707 ><P | 2734 ><P |
2708 >The binary for LWLINK is called "lwlink". Note that the binary is in lower | 2735 >The binary for LWLINK is called "lwlink". Note that the binary is in lower |
2709 case. lwlink takes the following command line arguments.</P | 2736 case. lwlink takes the following command line arguments.</P |
2897 ><DIV | 2924 ><DIV |
2898 CLASS="SECTION" | 2925 CLASS="SECTION" |
2899 ><HR><H2 | 2926 ><HR><H2 |
2900 CLASS="SECTION" | 2927 CLASS="SECTION" |
2901 ><A | 2928 ><A |
2902 NAME="AEN916" | 2929 NAME="AEN927" |
2903 >4.2. Linker Operation</A | 2930 >4.2. Linker Operation</A |
2904 ></H2 | 2931 ></H2 |
2905 ><P | 2932 ><P |
2906 > LWLINK takes one or more files in supported input formats and links them | 2933 > LWLINK takes one or more files in supported input formats and links them |
2907 into a single binary. Currently supported formats are the LWTOOLS object | 2934 into a single binary. Currently supported formats are the LWTOOLS object |
2953 ><DIV | 2980 ><DIV |
2954 CLASS="SECTION" | 2981 CLASS="SECTION" |
2955 ><HR><H2 | 2982 ><HR><H2 |
2956 CLASS="SECTION" | 2983 CLASS="SECTION" |
2957 ><A | 2984 ><A |
2958 NAME="AEN930" | 2985 NAME="AEN941" |
2959 >4.3. Linking Scripts</A | 2986 >4.3. Linking Scripts</A |
2960 ></H2 | 2987 ></H2 |
2961 ><P | 2988 ><P |
2962 >A linker script is used to instruct the linker about how to assemble the | 2989 >A linker script is used to instruct the linker about how to assemble the |
2963 various sections into a completed binary. It consists of a series of | 2990 various sections into a completed binary. It consists of a series of |
3157 ><DIV | 3184 ><DIV |
3158 CLASS="SECTION" | 3185 CLASS="SECTION" |
3159 ><HR><H2 | 3186 ><HR><H2 |
3160 CLASS="SECTION" | 3187 CLASS="SECTION" |
3161 ><A | 3188 ><A |
3162 NAME="AEN996" | 3189 NAME="AEN1007" |
3163 >4.4. Format Specific Linking Notes</A | 3190 >4.4. Format Specific Linking Notes</A |
3164 ></H2 | 3191 ></H2 |
3165 ><P | 3192 ><P |
3166 >Some formats require special information to be able to generate actual | 3193 >Some formats require special information to be able to generate actual |
3167 binaries. If the specific format you are interested in is not listed in | 3194 binaries. If the specific format you are interested in is not listed in |
3170 ><DIV | 3197 ><DIV |
3171 CLASS="SECTION" | 3198 CLASS="SECTION" |
3172 ><HR><H3 | 3199 ><HR><H3 |
3173 CLASS="SECTION" | 3200 CLASS="SECTION" |
3174 ><A | 3201 ><A |
3175 NAME="AEN999" | 3202 NAME="AEN1010" |
3176 >4.4.1. OS9 Modules</A | 3203 >4.4.1. OS9 Modules</A |
3177 ></H3 | 3204 ></H3 |
3178 ><P | 3205 ><P |
3179 >OS9 modules need to embed several items into the module header. These | 3206 >OS9 modules need to embed several items into the module header. These |
3180 items are the type of module, the langauge of the module, the module | 3207 items are the type of module, the langauge of the module, the module |
3246 ></DIV | 3273 ></DIV |
3247 ><DIV | 3274 ><DIV |
3248 CLASS="CHAPTER" | 3275 CLASS="CHAPTER" |
3249 ><HR><H1 | 3276 ><HR><H1 |
3250 ><A | 3277 ><A |
3251 NAME="AEN1011" | 3278 NAME="AEN1022" |
3252 ></A | 3279 ></A |
3253 >Chapter 5. Libraries and LWAR</H1 | 3280 >Chapter 5. Libraries and LWAR</H1 |
3254 ><P | 3281 ><P |
3255 >LWTOOLS also includes a tool for managing libraries. These are analogous to | 3282 >LWTOOLS also includes a tool for managing libraries. These are analogous to |
3256 the static libraries created with the "ar" tool on POSIX systems. Each library | 3283 the static libraries created with the "ar" tool on POSIX systems. Each library |
3265 ><DIV | 3292 ><DIV |
3266 CLASS="SECTION" | 3293 CLASS="SECTION" |
3267 ><HR><H2 | 3294 ><HR><H2 |
3268 CLASS="SECTION" | 3295 CLASS="SECTION" |
3269 ><A | 3296 ><A |
3270 NAME="AEN1015" | 3297 NAME="AEN1026" |
3271 >5.1. Command Line Options</A | 3298 >5.1. Command Line Options</A |
3272 ></H2 | 3299 ></H2 |
3273 ><P | 3300 ><P |
3274 >The binary for LWAR is called "lwar". Note that the binary is in lower | 3301 >The binary for LWAR is called "lwar". Note that the binary is in lower |
3275 case. The options lwar understands are listed below. For archive manipulation | 3302 case. The options lwar understands are listed below. For archive manipulation |
3466 followed by any data required by the term. Then end of the list is flagged | 3493 followed by any data required by the term. Then end of the list is flagged |
3467 by a NULL expression (only an end of expression term).</P | 3494 by a NULL expression (only an end of expression term).</P |
3468 ><DIV | 3495 ><DIV |
3469 CLASS="TABLE" | 3496 CLASS="TABLE" |
3470 ><A | 3497 ><A |
3471 NAME="AEN1098" | 3498 NAME="AEN1109" |
3472 ></A | 3499 ></A |
3473 ><P | 3500 ><P |
3474 ><B | 3501 ><B |
3475 >Table 6-1. Object File Term Types</B | 3502 >Table 6-1. Object File Term Types</B |
3476 ></P | 3503 ></P |
3538 allows local symbols that are not exported to have the same names as | 3565 allows local symbols that are not exported to have the same names as |
3539 exported symbols or external references.</P | 3566 exported symbols or external references.</P |
3540 ><DIV | 3567 ><DIV |
3541 CLASS="TABLE" | 3568 CLASS="TABLE" |
3542 ><A | 3569 ><A |
3543 NAME="AEN1128" | 3570 NAME="AEN1139" |
3544 ></A | 3571 ></A |
3545 ><P | 3572 ><P |
3546 ><B | 3573 ><B |
3547 >Table 6-2. Object File Operator Numbers</B | 3574 >Table 6-2. Object File Operator Numbers</B |
3548 ></P | 3575 ></P |