comparison doc/manual/c436.html @ 153:ffef3ea07399 2.1 2.1

Preparing for release
author lost
date Fri, 30 Jan 2009 04:32:55 +0000
parents
children
comparison
equal deleted inserted replaced
152:6bd4755d224f 153:ffef3ea07399
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="x407.html"><LINK
15 REL="NEXT"
16 TITLE="Linker Operation"
17 HREF="x510.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="x407.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="x510.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="AEN436"
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="AEN439"
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 >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 >--debug</CODE
181 >, <CODE
182 CLASS="OPTION"
183 >-d</CODE
184 ></DT
185 ><DD
186 ><P
187 >This option increases the debugging level. It is only useful for LWTOOLS
188 developers.</P
189 ></DD
190 ><DT
191 ><CODE
192 CLASS="OPTION"
193 >--help</CODE
194 >, <CODE
195 CLASS="OPTION"
196 >-?</CODE
197 ></DT
198 ><DD
199 ><P
200 >This provides a listing of command line options and a brief description
201 of each.</P
202 ></DD
203 ><DT
204 ><CODE
205 CLASS="OPTION"
206 >--usage</CODE
207 ></DT
208 ><DD
209 ><P
210 >This will display a usage summary.
211 of each.</P
212 ></DD
213 ><DT
214 ><CODE
215 CLASS="OPTION"
216 >--version</CODE
217 >, <CODE
218 CLASS="OPTION"
219 >-V</CODE
220 ></DT
221 ><DD
222 ><P
223 >This will display the version of LWLINK.
224 of each.</P
225 ></DD
226 ></DL
227 ></DIV
228 ></DIV
229 ></DIV
230 ><DIV
231 CLASS="NAVFOOTER"
232 ><HR
233 ALIGN="LEFT"
234 WIDTH="100%"><TABLE
235 SUMMARY="Footer navigation table"
236 WIDTH="100%"
237 BORDER="0"
238 CELLPADDING="0"
239 CELLSPACING="0"
240 ><TR
241 ><TD
242 WIDTH="33%"
243 ALIGN="left"
244 VALIGN="top"
245 ><A
246 HREF="x407.html"
247 ACCESSKEY="P"
248 >Prev</A
249 ></TD
250 ><TD
251 WIDTH="34%"
252 ALIGN="center"
253 VALIGN="top"
254 ><A
255 HREF="index.html"
256 ACCESSKEY="H"
257 >Home</A
258 ></TD
259 ><TD
260 WIDTH="33%"
261 ALIGN="right"
262 VALIGN="top"
263 ><A
264 HREF="x510.html"
265 ACCESSKEY="N"
266 >Next</A
267 ></TD
268 ></TR
269 ><TR
270 ><TD
271 WIDTH="33%"
272 ALIGN="left"
273 VALIGN="top"
274 >Assembler Modes and Pragmas</TD
275 ><TD
276 WIDTH="34%"
277 ALIGN="center"
278 VALIGN="top"
279 >&nbsp;</TD
280 ><TD
281 WIDTH="33%"
282 ALIGN="right"
283 VALIGN="top"
284 >Linker Operation</TD
285 ></TR
286 ></TABLE
287 ></DIV
288 ></BODY
289 ></HTML
290 >