Mercurial > hg > index.cgi

comparison docs/manual/manual.html @ 489:52af0aa54fe5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 >&#13;Numbers can be expressed in binary, octal, decimal, or hexadecimal. Binary 1017 >&#13;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 >&#13;Structures are used to group related data in a fixed structure. A structure 1910 >&#13;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 >&#13;The following options for displaying cycle counts in listings are provided. 2685 >&#13;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 >&#13;LWLINK takes one or more files in supported input formats and links them 2933 >&#13;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