comparison docs/manual/c693.html @ 254:155799f6cfa5

Add documentation for the FILL pseudo operation
author William Astle <lost@l-w.ca>
date Wed, 30 Jan 2013 21:32:14 -0700
parents
children
comparison
equal deleted inserted replaced
253:ed1009bce533 254:155799f6cfa5
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="x599.html"><LINK
15 REL="NEXT"
16 TITLE="Linker Operation"
17 HREF="x793.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="x599.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="x793.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="AEN693"
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="AEN696"
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="x599.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="x793.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 >