comparison docs/manual/c713.html @ 324:b30091890d62

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