Mercurial > hg > index.cgi

annotate docs/manual/c681.html @ 235:e3741cf53e00

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix error messages related to undefined symbols in lwlink Make lwlink not complain about seciton base and length symbols. Also silence duplicate complaints about undefined symbols. There is no need to complain about undefined symbols during the file/section resolution stage! If they are truly undefined, they'll still be undefined at the reference resolution stage.
author William Astle <lost@l-w.ca>
date Sat, 11 Aug 2012 15:18:58 -0600
parents 2cc599f1bebf
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
231
2cc599f1bebf Added --define to lwasm documentation.
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">
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
2 <HTML
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
3 ><HEAD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
4 ><TITLE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
5 >LWLINK</TITLE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
6 ><META
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
7 NAME="GENERATOR"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
9 REL="HOME"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
10 TITLE="LW Tool Chain"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
11 HREF="index.html"><LINK
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
12 REL="PREVIOUS"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
13 TITLE="Assembler Modes and Pragmas"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
14 HREF="x591.html"><LINK
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
15 REL="NEXT"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
16 TITLE="Linker Operation"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
17 HREF="x781.html"></HEAD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
18 ><BODY
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
19 CLASS="CHAPTER"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
20 BGCOLOR="#FFFFFF"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
21 TEXT="#000000"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
22 LINK="#0000FF"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
23 VLINK="#840084"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
24 ALINK="#0000FF"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
25 ><DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
26 CLASS="NAVHEADER"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
27 ><TABLE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
28 SUMMARY="Header navigation table"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
29 WIDTH="100%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
30 BORDER="0"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
31 CELLPADDING="0"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
32 CELLSPACING="0"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
33 ><TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
34 ><TH
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
35 COLSPAN="3"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
36 ALIGN="center"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
37 >LW Tool Chain</TH
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
38 ></TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
39 ><TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
40 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
41 WIDTH="10%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
42 ALIGN="left"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
43 VALIGN="bottom"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
44 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
45 HREF="x591.html"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
46 ACCESSKEY="P"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
47 >Prev</A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
48 ></TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
49 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
50 WIDTH="80%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
51 ALIGN="center"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
52 VALIGN="bottom"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
53 ></TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
54 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
55 WIDTH="10%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
56 ALIGN="right"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
57 VALIGN="bottom"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
58 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
59 HREF="x781.html"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
60 ACCESSKEY="N"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
61 >Next</A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
62 ></TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
63 ></TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
64 ></TABLE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
65 ><HR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
66 ALIGN="LEFT"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
67 WIDTH="100%"></DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
68 ><DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
69 CLASS="CHAPTER"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
70 ><H1
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
71 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
72 NAME="AEN681"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
73 ></A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
74 >Chapter 4. LWLINK</H1
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
75 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
76 >The LWTOOLS linker is called LWLINK. This chapter documents the various features
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
77 of the linker.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
78 ><DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
79 CLASS="SECTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
80 ><H1
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
81 CLASS="SECTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
82 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
83 NAME="AEN684"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
84 >4.1. Command Line Options</A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
85 ></H1
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
86 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
87 >The binary for LWLINK is called "lwlink". Note that the binary is in lower
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
88 case. lwlink takes the following command line arguments.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
89 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
90 ></P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
91 ><DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
92 CLASS="VARIABLELIST"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
93 ><DL
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
94 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
95 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
96 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
97 >--decb</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
98 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
99 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
100 >-b</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
101 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
102 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
103 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
104 >Selects the DECB output format target. This is equivalent to <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
105 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
106 >--format=decb</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
107 ></P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
108 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
109 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
110 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
111 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
112 >--output=FILE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
113 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
114 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
115 >-o FILE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
116 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
117 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
118 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
119 >This option specifies the name of the output file. If not specified, the
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
120 default is <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
121 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
122 >a.out</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
123 >.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
124 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
125 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
126 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
127 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
128 >--format=TYPE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
129 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
130 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
131 >-f TYPE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
132 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
133 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
134 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
135 >This option specifies the output format. Valid values are <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
136 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
137 >decb</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
138 >
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
139 and <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
140 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
141 >raw</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
142 ></P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
143 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
144 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
145 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
146 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
147 >--raw</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
148 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
149 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
150 >-r</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
151 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
152 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
153 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
154 >This option specifies the raw output format.
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
155 It is equivalent to <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
156 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
157 >--format=raw</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
158 >
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
159 and <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
160 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
161 >-f raw</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
162 ></P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
163 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
164 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
165 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
166 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
167 >--script=FILE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
168 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
169 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
170 >-s</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
171 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
172 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
173 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
174 >This option allows specifying a linking script to override the linker's
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
175 built in defaults.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
176 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
177 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
178 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
179 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
180 >--section-base=SECT=BASE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
181 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
182 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
183 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
184 >Cause section SECT to load at base address BASE. This will be prepended
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
185 to the built-in link script. It is ignored if a link script is provided.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
186 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
187 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
188 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
189 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
190 >--map=FILE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
191 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
192 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
193 >-m FILE</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
194 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
195 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
196 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
197 >This will output a description of the link result to FILE.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
198 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
199 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
200 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
201 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
202 >--library=LIBSPEC</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
203 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
204 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
205 >-l LIBSPEC</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
206 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
207 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
208 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
209 >Load a library using the library search path. LIBSPEC will have "lib" prepended
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
210 and ".a" appended.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
211 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
212 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
213 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
214 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
215 >--library-path=DIR</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
216 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
217 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
218 >-L DIR</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
219 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
220 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
221 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
222 >Add DIR to the library search path.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
223 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
224 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
225 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
226 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
227 >--debug</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
228 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
229 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
230 >-d</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
231 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
232 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
233 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
234 >This option increases the debugging level. It is only useful for LWTOOLS
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
235 developers.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
236 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
237 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
238 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
239 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
240 >--help</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
241 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
242 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
243 >-?</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
244 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
245 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
246 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
247 >This provides a listing of command line options and a brief description
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
248 of each.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
249 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
250 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
251 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
252 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
253 >--usage</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
254 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
255 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
256 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
257 >This will display a usage summary
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
258 of each command line option.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
259 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
260 ><DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
261 ><CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
262 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
263 >--version</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
264 >, <CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
265 CLASS="OPTION"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
266 >-V</CODE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
267 ></DT
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
268 ><DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
269 ><P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
270 >This will display the version of LWLINK.</P
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
271 ></DD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
272 ></DL
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
273 ></DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
274 ></DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
275 ></DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
276 ><DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
277 CLASS="NAVFOOTER"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
278 ><HR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
279 ALIGN="LEFT"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
280 WIDTH="100%"><TABLE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
281 SUMMARY="Footer navigation table"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
282 WIDTH="100%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
283 BORDER="0"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
284 CELLPADDING="0"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
285 CELLSPACING="0"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
286 ><TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
287 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
288 WIDTH="33%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
289 ALIGN="left"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
290 VALIGN="top"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
291 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
292 HREF="x591.html"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
293 ACCESSKEY="P"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
294 >Prev</A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
295 ></TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
296 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
297 WIDTH="34%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
298 ALIGN="center"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
299 VALIGN="top"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
300 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
301 HREF="index.html"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
302 ACCESSKEY="H"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
303 >Home</A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
304 ></TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
305 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
306 WIDTH="33%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
307 ALIGN="right"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
308 VALIGN="top"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
309 ><A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
310 HREF="x781.html"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
311 ACCESSKEY="N"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
312 >Next</A
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
313 ></TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
314 ></TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
315 ><TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
316 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
317 WIDTH="33%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
318 ALIGN="left"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
319 VALIGN="top"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
320 >Assembler Modes and Pragmas</TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
321 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
322 WIDTH="34%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
323 ALIGN="center"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
324 VALIGN="top"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
325 >&nbsp;</TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
326 ><TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
327 WIDTH="33%"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
328 ALIGN="right"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
329 VALIGN="top"
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
330 >Linker Operation</TD
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
331 ></TR
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
332 ></TABLE
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
333 ></DIV
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
334 ></BODY
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
335 ></HTML
2cc599f1bebf Added --define to lwasm documentation.
William Astle <lost@l-w.ca>
parents:
diff changeset
336 >