Mercurial > hg > index.cgi
comparison docs/manual/manual.html @ 369:682524a1f32f
Updated documentation for --symbols-nolocals and --map
author | William Astle <lost@l-w.ca> |
---|---|
date | Mon, 22 Jun 2015 18:38:30 -0600 |
parents | 379ef4e08dd2 |
children | fc166b3bbae3 |
comparison
equal
deleted
inserted
replaced
368:362f8fb0695b | 369:682524a1f32f |
---|---|
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="#AEN197" | 124 HREF="#AEN208" |
125 >Dialects</A | 125 >Dialects</A |
126 ></DT | 126 ></DT |
127 ><DT | 127 ><DT |
128 >3.3. <A | 128 >3.3. <A |
129 HREF="#AEN206" | 129 HREF="#AEN217" |
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="#AEN216" | 134 HREF="#AEN227" |
135 >Symbols</A | 135 >Symbols</A |
136 ></DT | 136 ></DT |
137 ><DT | 137 ><DT |
138 >3.5. <A | 138 >3.5. <A |
139 HREF="#AEN221" | 139 HREF="#AEN232" |
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="#AEN229" | 144 HREF="#AEN240" |
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="#AEN232" | 151 HREF="#AEN243" |
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="#AEN343" | 156 HREF="#AEN354" |
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="#AEN390" | 161 HREF="#AEN401" |
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="#AEN455" | 166 HREF="#AEN466" |
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="#AEN480" | 171 HREF="#AEN491" |
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="#AEN520" | 178 HREF="#AEN531" |
179 >Macros</A | 179 >Macros</A |
180 ></DT | 180 ></DT |
181 ><DT | 181 ><DT |
182 >3.8. <A | 182 >3.8. <A |
183 HREF="#AEN543" | 183 HREF="#AEN554" |
184 >Structures</A | 184 >Structures</A |
185 ></DT | 185 ></DT |
186 ><DT | 186 ><DT |
187 >3.9. <A | 187 >3.9. <A |
188 HREF="#AEN564" | 188 HREF="#AEN575" |
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="#AEN628" | 193 HREF="#AEN639" |
194 >Assembler Modes and Pragmas</A | 194 >Assembler Modes and Pragmas</A |
195 ></DT | 195 ></DT |
196 ></DL | 196 ></DL |
197 ></DD | 197 ></DD |
198 ><DT | 198 ><DT |
199 >4. <A | 199 >4. <A |
200 HREF="#AEN734" | 200 HREF="#AEN745" |
201 >LWLINK</A | 201 >LWLINK</A |
202 ></DT | 202 ></DT |
203 ><DD | 203 ><DD |
204 ><DL | 204 ><DL |
205 ><DT | 205 ><DT |
206 >4.1. <A | 206 >4.1. <A |
207 HREF="#AEN737" | 207 HREF="#AEN748" |
208 >Command Line Options</A | 208 >Command Line Options</A |
209 ></DT | 209 ></DT |
210 ><DT | 210 ><DT |
211 >4.2. <A | 211 >4.2. <A |
212 HREF="#AEN834" | 212 HREF="#AEN845" |
213 >Linker Operation</A | 213 >Linker Operation</A |
214 ></DT | 214 ></DT |
215 ><DT | 215 ><DT |
216 >4.3. <A | 216 >4.3. <A |
217 HREF="#AEN848" | 217 HREF="#AEN859" |
218 >Linking Scripts</A | 218 >Linking Scripts</A |
219 ></DT | 219 ></DT |
220 ><DT | 220 ><DT |
221 >4.4. <A | 221 >4.4. <A |
222 HREF="#AEN914" | 222 HREF="#AEN925" |
223 >Format Specific Linking Notes</A | 223 >Format Specific Linking Notes</A |
224 ></DT | 224 ></DT |
225 ><DD | 225 ><DD |
226 ><DL | 226 ><DL |
227 ><DT | 227 ><DT |
228 >4.4.1. <A | 228 >4.4.1. <A |
229 HREF="#AEN917" | 229 HREF="#AEN928" |
230 >OS9 Modules</A | 230 >OS9 Modules</A |
231 ></DT | 231 ></DT |
232 ></DL | 232 ></DL |
233 ></DD | 233 ></DD |
234 ></DL | 234 ></DL |
235 ></DD | 235 ></DD |
236 ><DT | 236 ><DT |
237 >5. <A | 237 >5. <A |
238 HREF="#AEN929" | 238 HREF="#AEN940" |
239 >Libraries and LWAR</A | 239 >Libraries and LWAR</A |
240 ></DT | 240 ></DT |
241 ><DD | 241 ><DD |
242 ><DL | 242 ><DL |
243 ><DT | 243 ><DT |
244 >5.1. <A | 244 >5.1. <A |
245 HREF="#AEN933" | 245 HREF="#AEN944" |
246 >Command Line Options</A | 246 >Command Line Options</A |
247 ></DT | 247 ></DT |
248 ></DL | 248 ></DL |
249 ></DD | 249 ></DD |
250 ><DT | 250 ><DT |
262 ><B | 262 ><B |
263 >List of Tables</B | 263 >List of Tables</B |
264 ></DT | 264 ></DT |
265 ><DT | 265 ><DT |
266 >6-1. <A | 266 >6-1. <A |
267 HREF="#AEN1016" | 267 HREF="#AEN1027" |
268 >Object File Term Types</A | 268 >Object File Term Types</A |
269 ></DT | 269 ></DT |
270 ><DT | 270 ><DT |
271 >6-2. <A | 271 >6-2. <A |
272 HREF="#AEN1046" | 272 HREF="#AEN1057" |
273 >Object File Operator Numbers</A | 273 >Object File Operator Numbers</A |
274 ></DT | 274 ></DT |
275 ></DL | 275 ></DL |
276 ></DIV | 276 ></DIV |
277 ><DIV | 277 ><DIV |
677 It has no effect unless a listing is being generated.</P | 677 It has no effect unless a listing is being generated.</P |
678 ></DD | 678 ></DD |
679 ><DT | 679 ><DT |
680 ><CODE | 680 ><CODE |
681 CLASS="OPTION" | 681 CLASS="OPTION" |
682 >--symbols-nolocals</CODE | |
683 ></DT | |
684 ><DD | |
685 ><P | |
686 >Behaves just like <CODE | |
687 CLASS="OPTION" | |
688 >--symbols</CODE | |
689 > but with local labels omitted.</P | |
690 ></DD | |
691 ><DT | |
692 ><CODE | |
693 CLASS="OPTION" | |
694 >--map=FILE</CODE | |
695 ></DT | |
696 ><DD | |
697 ><P | |
698 > 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 | |
699 ></DD | |
700 ><DT | |
701 ><CODE | |
702 CLASS="OPTION" | |
682 >--obj</CODE | 703 >--obj</CODE |
683 ></DT | 704 ></DT |
684 ><DD | 705 ><DD |
685 ><P | 706 ><P |
686 >Select the proprietary object file format as the output target.</P | 707 >Select the proprietary object file format as the output target.</P |
810 ><DIV | 831 ><DIV |
811 CLASS="SECTION" | 832 CLASS="SECTION" |
812 ><HR><H2 | 833 ><HR><H2 |
813 CLASS="SECTION" | 834 CLASS="SECTION" |
814 ><A | 835 ><A |
815 NAME="AEN197" | 836 NAME="AEN208" |
816 >3.2. Dialects</A | 837 >3.2. Dialects</A |
817 ></H2 | 838 ></H2 |
818 ><P | 839 ><P |
819 > LWASM supports all documented MC6809 instructions as defined by | 840 > LWASM supports all documented MC6809 instructions as defined by |
820 Motorola. By default, this does not include any MC6800 compatibility | 841 Motorola. By default, this does not include any MC6800 compatibility |
854 ><DIV | 875 ><DIV |
855 CLASS="SECTION" | 876 CLASS="SECTION" |
856 ><HR><H2 | 877 ><HR><H2 |
857 CLASS="SECTION" | 878 CLASS="SECTION" |
858 ><A | 879 ><A |
859 NAME="AEN206" | 880 NAME="AEN217" |
860 >3.3. Source Format</A | 881 >3.3. Source Format</A |
861 ></H2 | 882 ></H2 |
862 ><P | 883 ><P |
863 >LWASM accepts plain text files in a relatively free form. It can handle | 884 >LWASM accepts plain text files in a relatively free form. It can handle |
864 lines terminated with CR, LF, CRLF, or LFCR which means it should be able | 885 lines terminated with CR, LF, CRLF, or LFCR which means it should be able |
900 ><DIV | 921 ><DIV |
901 CLASS="SECTION" | 922 CLASS="SECTION" |
902 ><HR><H2 | 923 ><HR><H2 |
903 CLASS="SECTION" | 924 CLASS="SECTION" |
904 ><A | 925 ><A |
905 NAME="AEN216" | 926 NAME="AEN227" |
906 >3.4. Symbols</A | 927 >3.4. Symbols</A |
907 ></H2 | 928 ></H2 |
908 ><P | 929 ><P |
909 >Symbols have no length restriction. They may contain letters, numbers, dots, | 930 >Symbols have no length restriction. They may contain letters, numbers, dots, |
910 dollar signs, and underscores. They must start with a letter, dot, or | 931 dollar signs, and underscores. They must start with a letter, dot, or |
928 ><DIV | 949 ><DIV |
929 CLASS="SECTION" | 950 CLASS="SECTION" |
930 ><HR><H2 | 951 ><HR><H2 |
931 CLASS="SECTION" | 952 CLASS="SECTION" |
932 ><A | 953 ><A |
933 NAME="AEN221" | 954 NAME="AEN232" |
934 >3.5. Numbers and Expressions</A | 955 >3.5. Numbers and Expressions</A |
935 ></H2 | 956 ></H2 |
936 ><P | 957 ><P |
937 > Numbers can be expressed in binary, octal, decimal, or hexadecimal. Binary | 958 > Numbers can be expressed in binary, octal, decimal, or hexadecimal. Binary |
938 numbers may be prefixed with a "%" symbol or suffixed with a "b" or "B". | 959 numbers may be prefixed with a "%" symbol or suffixed with a "b" or "B". |
973 ><DIV | 994 ><DIV |
974 CLASS="SECTION" | 995 CLASS="SECTION" |
975 ><HR><H2 | 996 ><HR><H2 |
976 CLASS="SECTION" | 997 CLASS="SECTION" |
977 ><A | 998 ><A |
978 NAME="AEN229" | 999 NAME="AEN240" |
979 >3.6. Assembler Directives</A | 1000 >3.6. Assembler Directives</A |
980 ></H2 | 1001 ></H2 |
981 ><P | 1002 ><P |
982 >Various directives can be used to control the behaviour of the | 1003 >Various directives can be used to control the behaviour of the |
983 assembler or to include non-code/data in the resulting output. Those directives | 1004 assembler or to include non-code/data in the resulting output. Those directives |
986 ><DIV | 1007 ><DIV |
987 CLASS="SECTION" | 1008 CLASS="SECTION" |
988 ><HR><H3 | 1009 ><HR><H3 |
989 CLASS="SECTION" | 1010 CLASS="SECTION" |
990 ><A | 1011 ><A |
991 NAME="AEN232" | 1012 NAME="AEN243" |
992 >3.6.1. Data Directives</A | 1013 >3.6.1. Data Directives</A |
993 ></H3 | 1014 ></H3 |
994 ><P | 1015 ><P |
995 ></P | 1016 ></P |
996 ><DIV | 1017 ><DIV |
1220 ><DIV | 1241 ><DIV |
1221 CLASS="SECTION" | 1242 CLASS="SECTION" |
1222 ><HR><H3 | 1243 ><HR><H3 |
1223 CLASS="SECTION" | 1244 CLASS="SECTION" |
1224 ><A | 1245 ><A |
1225 NAME="AEN343" | 1246 NAME="AEN354" |
1226 >3.6.2. Address Definition</A | 1247 >3.6.2. Address Definition</A |
1227 ></H3 | 1248 ></H3 |
1228 ><P | 1249 ><P |
1229 >The directives in this section all control the addresses of symbols | 1250 >The directives in this section all control the addresses of symbols |
1230 or the assembly process itself.</P | 1251 or the assembly process itself.</P |
1356 ><DIV | 1377 ><DIV |
1357 CLASS="SECTION" | 1378 CLASS="SECTION" |
1358 ><HR><H3 | 1379 ><HR><H3 |
1359 CLASS="SECTION" | 1380 CLASS="SECTION" |
1360 ><A | 1381 ><A |
1361 NAME="AEN390" | 1382 NAME="AEN401" |
1362 >3.6.3. Conditional Assembly</A | 1383 >3.6.3. Conditional Assembly</A |
1363 ></H3 | 1384 ></H3 |
1364 ><P | 1385 ><P |
1365 >Portions of the source code can be excluded or included based on conditions | 1386 >Portions of the source code can be excluded or included based on conditions |
1366 known at assembly time. Conditionals can be nested arbitrarily deeply. The | 1387 known at assembly time. Conditionals can be nested arbitrarily deeply. The |
1519 ><DIV | 1540 ><DIV |
1520 CLASS="SECTION" | 1541 CLASS="SECTION" |
1521 ><HR><H3 | 1542 ><HR><H3 |
1522 CLASS="SECTION" | 1543 CLASS="SECTION" |
1523 ><A | 1544 ><A |
1524 NAME="AEN455" | 1545 NAME="AEN466" |
1525 >3.6.4. OS9 Target Directives</A | 1546 >3.6.4. OS9 Target Directives</A |
1526 ></H3 | 1547 ></H3 |
1527 ><P | 1548 ><P |
1528 >This section includes directives that apply solely to the OS9 | 1549 >This section includes directives that apply solely to the OS9 |
1529 target.</P | 1550 target.</P |
1586 ><DIV | 1607 ><DIV |
1587 CLASS="SECTION" | 1608 CLASS="SECTION" |
1588 ><HR><H3 | 1609 ><HR><H3 |
1589 CLASS="SECTION" | 1610 CLASS="SECTION" |
1590 ><A | 1611 ><A |
1591 NAME="AEN480" | 1612 NAME="AEN491" |
1592 >3.6.5. Miscelaneous Directives</A | 1613 >3.6.5. Miscelaneous Directives</A |
1593 ></H3 | 1614 ></H3 |
1594 ><P | 1615 ><P |
1595 >This section includes directives that do not fit into the other | 1616 >This section includes directives that do not fit into the other |
1596 categories.</P | 1617 categories.</P |
1700 ><DIV | 1721 ><DIV |
1701 CLASS="SECTION" | 1722 CLASS="SECTION" |
1702 ><HR><H2 | 1723 ><HR><H2 |
1703 CLASS="SECTION" | 1724 CLASS="SECTION" |
1704 ><A | 1725 ><A |
1705 NAME="AEN520" | 1726 NAME="AEN531" |
1706 >3.7. Macros</A | 1727 >3.7. Macros</A |
1707 ></H2 | 1728 ></H2 |
1708 ><P | 1729 ><P |
1709 >LWASM is a macro assembler. A macro is simply a name that stands in for a | 1730 >LWASM is a macro assembler. A macro is simply a name that stands in for a |
1710 series of instructions. Once a macro is defined, it is used like any other | 1731 series of instructions. Once a macro is defined, it is used like any other |
1799 ><DIV | 1820 ><DIV |
1800 CLASS="SECTION" | 1821 CLASS="SECTION" |
1801 ><HR><H2 | 1822 ><HR><H2 |
1802 CLASS="SECTION" | 1823 CLASS="SECTION" |
1803 ><A | 1824 ><A |
1804 NAME="AEN543" | 1825 NAME="AEN554" |
1805 >3.8. Structures</A | 1826 >3.8. Structures</A |
1806 ></H2 | 1827 ></H2 |
1807 ><P | 1828 ><P |
1808 > Structures are used to group related data in a fixed structure. A structure | 1829 > Structures are used to group related data in a fixed structure. A structure |
1809 consists a number of fields, defined in sequential order and which take up | 1830 consists a number of fields, defined in sequential order and which take up |
1892 ><DIV | 1913 ><DIV |
1893 CLASS="SECTION" | 1914 CLASS="SECTION" |
1894 ><HR><H2 | 1915 ><HR><H2 |
1895 CLASS="SECTION" | 1916 CLASS="SECTION" |
1896 ><A | 1917 ><A |
1897 NAME="AEN564" | 1918 NAME="AEN575" |
1898 >3.9. Object Files and Sections</A | 1919 >3.9. Object Files and Sections</A |
1899 ></H2 | 1920 ></H2 |
1900 ><P | 1921 ><P |
1901 >The object file target is very useful for large project because it allows | 1922 >The object file target is very useful for large project because it allows |
1902 multiple files to be assembled independently and then linked into the final | 1923 multiple files to be assembled independently and then linked into the final |
2109 ><DIV | 2130 ><DIV |
2110 CLASS="SECTION" | 2131 CLASS="SECTION" |
2111 ><HR><H2 | 2132 ><HR><H2 |
2112 CLASS="SECTION" | 2133 CLASS="SECTION" |
2113 ><A | 2134 ><A |
2114 NAME="AEN628" | 2135 NAME="AEN639" |
2115 >3.10. Assembler Modes and Pragmas</A | 2136 >3.10. Assembler Modes and Pragmas</A |
2116 ></H2 | 2137 ></H2 |
2117 ><P | 2138 ><P |
2118 >There are a number of options that affect the way assembly is performed. | 2139 >There are a number of options that affect the way assembly is performed. |
2119 Some of these options can only be specified on the command line because | 2140 Some of these options can only be specified on the command line because |
2432 ></DIV | 2453 ></DIV |
2433 ><DIV | 2454 ><DIV |
2434 CLASS="CHAPTER" | 2455 CLASS="CHAPTER" |
2435 ><HR><H1 | 2456 ><HR><H1 |
2436 ><A | 2457 ><A |
2437 NAME="AEN734" | 2458 NAME="AEN745" |
2438 ></A | 2459 ></A |
2439 >Chapter 4. LWLINK</H1 | 2460 >Chapter 4. LWLINK</H1 |
2440 ><P | 2461 ><P |
2441 >The LWTOOLS linker is called LWLINK. This chapter documents the various features | 2462 >The LWTOOLS linker is called LWLINK. This chapter documents the various features |
2442 of the linker.</P | 2463 of the linker.</P |
2443 ><DIV | 2464 ><DIV |
2444 CLASS="SECTION" | 2465 CLASS="SECTION" |
2445 ><HR><H2 | 2466 ><HR><H2 |
2446 CLASS="SECTION" | 2467 CLASS="SECTION" |
2447 ><A | 2468 ><A |
2448 NAME="AEN737" | 2469 NAME="AEN748" |
2449 >4.1. Command Line Options</A | 2470 >4.1. Command Line Options</A |
2450 ></H2 | 2471 ></H2 |
2451 ><P | 2472 ><P |
2452 >The binary for LWLINK is called "lwlink". Note that the binary is in lower | 2473 >The binary for LWLINK is called "lwlink". Note that the binary is in lower |
2453 case. lwlink takes the following command line arguments.</P | 2474 case. lwlink takes the following command line arguments.</P |
2640 ><DIV | 2661 ><DIV |
2641 CLASS="SECTION" | 2662 CLASS="SECTION" |
2642 ><HR><H2 | 2663 ><HR><H2 |
2643 CLASS="SECTION" | 2664 CLASS="SECTION" |
2644 ><A | 2665 ><A |
2645 NAME="AEN834" | 2666 NAME="AEN845" |
2646 >4.2. Linker Operation</A | 2667 >4.2. Linker Operation</A |
2647 ></H2 | 2668 ></H2 |
2648 ><P | 2669 ><P |
2649 > LWLINK takes one or more files in supported input formats and links them | 2670 > LWLINK takes one or more files in supported input formats and links them |
2650 into a single binary. Currently supported formats are the LWTOOLS object | 2671 into a single binary. Currently supported formats are the LWTOOLS object |
2696 ><DIV | 2717 ><DIV |
2697 CLASS="SECTION" | 2718 CLASS="SECTION" |
2698 ><HR><H2 | 2719 ><HR><H2 |
2699 CLASS="SECTION" | 2720 CLASS="SECTION" |
2700 ><A | 2721 ><A |
2701 NAME="AEN848" | 2722 NAME="AEN859" |
2702 >4.3. Linking Scripts</A | 2723 >4.3. Linking Scripts</A |
2703 ></H2 | 2724 ></H2 |
2704 ><P | 2725 ><P |
2705 >A linker script is used to instruct the linker about how to assemble the | 2726 >A linker script is used to instruct the linker about how to assemble the |
2706 various sections into a completed binary. It consists of a series of | 2727 various sections into a completed binary. It consists of a series of |
2900 ><DIV | 2921 ><DIV |
2901 CLASS="SECTION" | 2922 CLASS="SECTION" |
2902 ><HR><H2 | 2923 ><HR><H2 |
2903 CLASS="SECTION" | 2924 CLASS="SECTION" |
2904 ><A | 2925 ><A |
2905 NAME="AEN914" | 2926 NAME="AEN925" |
2906 >4.4. Format Specific Linking Notes</A | 2927 >4.4. Format Specific Linking Notes</A |
2907 ></H2 | 2928 ></H2 |
2908 ><P | 2929 ><P |
2909 >Some formats require special information to be able to generate actual | 2930 >Some formats require special information to be able to generate actual |
2910 binaries. If the specific format you are interested in is not listed in | 2931 binaries. If the specific format you are interested in is not listed in |
2913 ><DIV | 2934 ><DIV |
2914 CLASS="SECTION" | 2935 CLASS="SECTION" |
2915 ><HR><H3 | 2936 ><HR><H3 |
2916 CLASS="SECTION" | 2937 CLASS="SECTION" |
2917 ><A | 2938 ><A |
2918 NAME="AEN917" | 2939 NAME="AEN928" |
2919 >4.4.1. OS9 Modules</A | 2940 >4.4.1. OS9 Modules</A |
2920 ></H3 | 2941 ></H3 |
2921 ><P | 2942 ><P |
2922 >OS9 modules need to embed several items into the module header. These | 2943 >OS9 modules need to embed several items into the module header. These |
2923 items are the type of module, the langauge of the module, the module | 2944 items are the type of module, the langauge of the module, the module |
2989 ></DIV | 3010 ></DIV |
2990 ><DIV | 3011 ><DIV |
2991 CLASS="CHAPTER" | 3012 CLASS="CHAPTER" |
2992 ><HR><H1 | 3013 ><HR><H1 |
2993 ><A | 3014 ><A |
2994 NAME="AEN929" | 3015 NAME="AEN940" |
2995 ></A | 3016 ></A |
2996 >Chapter 5. Libraries and LWAR</H1 | 3017 >Chapter 5. Libraries and LWAR</H1 |
2997 ><P | 3018 ><P |
2998 >LWTOOLS also includes a tool for managing libraries. These are analogous to | 3019 >LWTOOLS also includes a tool for managing libraries. These are analogous to |
2999 the static libraries created with the "ar" tool on POSIX systems. Each library | 3020 the static libraries created with the "ar" tool on POSIX systems. Each library |
3008 ><DIV | 3029 ><DIV |
3009 CLASS="SECTION" | 3030 CLASS="SECTION" |
3010 ><HR><H2 | 3031 ><HR><H2 |
3011 CLASS="SECTION" | 3032 CLASS="SECTION" |
3012 ><A | 3033 ><A |
3013 NAME="AEN933" | 3034 NAME="AEN944" |
3014 >5.1. Command Line Options</A | 3035 >5.1. Command Line Options</A |
3015 ></H2 | 3036 ></H2 |
3016 ><P | 3037 ><P |
3017 >The binary for LWAR is called "lwar". Note that the binary is in lower | 3038 >The binary for LWAR is called "lwar". Note that the binary is in lower |
3018 case. The options lwar understands are listed below. For archive manipulation | 3039 case. The options lwar understands are listed below. For archive manipulation |
3209 followed by any data required by the term. Then end of the list is flagged | 3230 followed by any data required by the term. Then end of the list is flagged |
3210 by a NULL expression (only an end of expression term).</P | 3231 by a NULL expression (only an end of expression term).</P |
3211 ><DIV | 3232 ><DIV |
3212 CLASS="TABLE" | 3233 CLASS="TABLE" |
3213 ><A | 3234 ><A |
3214 NAME="AEN1016" | 3235 NAME="AEN1027" |
3215 ></A | 3236 ></A |
3216 ><P | 3237 ><P |
3217 ><B | 3238 ><B |
3218 >Table 6-1. Object File Term Types</B | 3239 >Table 6-1. Object File Term Types</B |
3219 ></P | 3240 ></P |
3281 allows local symbols that are not exported to have the same names as | 3302 allows local symbols that are not exported to have the same names as |
3282 exported symbols or external references.</P | 3303 exported symbols or external references.</P |
3283 ><DIV | 3304 ><DIV |
3284 CLASS="TABLE" | 3305 CLASS="TABLE" |
3285 ><A | 3306 ><A |
3286 NAME="AEN1046" | 3307 NAME="AEN1057" |
3287 ></A | 3308 ></A |
3288 ><P | 3309 ><P |
3289 ><B | 3310 ><B |
3290 >Table 6-2. Object File Operator Numbers</B | 3311 >Table 6-2. Object File Operator Numbers</B |
3291 ></P | 3312 ></P |