Mercurial > hg > index.cgi

annotate docs/manual/c806.html @ 442:61580fc48f98

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