1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<title>makelcf.exe</title>
9</head>
10
11<body>
12
13<H1>makelcf.exe</H1>
14
15<H2>Location</H2>
16<p><code>$REVOLUTION_SDK_ROOT/X86/bin/</code></p>
17
18<H2>Overview</H2>
19<p>
20Generates a linker command file and a symbol list for the static module from all dynamic (relocatable) module files.
21</p>
22
23<H2>Description</H2>
24<p>
25This program predicts the export information of static module from import information (information to reference external module) and export information (information to allow referencing from external module) of all dynamic modules. It then creates the linker command file and symbol list of the static module.<br>Specifically, this program collects the export symbol information and outputs it after removing duplicate symbols and symbols that are present in the import information.<br>
26</p>
27<p>
28The symbol list is used to generate the static module's module file (<code>.sel</code>).(See <code><a href="./makerso.html">makerso.exe</a></code>.)
29</p>
30
31<H2>Options</H2>
32<H3>-o &lt;Linker Command File&gt;</H3>
33<p>
34Specifies the name of the linker command file to output.<br> When this is omitted, the output file name is <code>static.lcf</code>.
35</p>
36<H3>-s &lt;Symbol List&gt;</H3>
37<p>
38Specifies the file name of the symbol list to output.<br> When this is omitted, the output file name is <code>symbol.lst</code>.
39</p>
40<H3>-t &lt;Linker Command File Template&gt;</H3>
41<p>
42Specifies the template for the linker command file.<br> Specify <CODE>&lt;revolution/eppc.$(PLATFORM).lcf&gt;</CODE>.<br>This cannot be omitted.
43</p>
44<H3>@&lt;Response File&gt;</H3>
45<p>
46You can also configure and specify the arguments through a response file which lists the arguments.
47</p>
48<H2>Return Values</H2>
49<TABLE border="1">
50  <TBODY>
51    <TR>
52      <TD align=center width="20">0</TD>
53<TD width="400">Conversion successful.</TD>
54    </TR>
55    <TR>
56      <TD align=center width="20">1</TD>
57<TD width="400">An error that does not fall under the following errors.</TD>
58    </TR>
59    <TR>
60      <TD align=center width="20">2</TD>
61<TD width="400">RSO file read failed.</TD>
62    </TR>
63    <TR>
64      <TD align=center width="20">3</TD>
65<TD width="400">No RSO file specified.</TD>
66    </TR>
67    <TR>
68      <TD align=center width="20">4</TD>
69<TD width="400">Linker command filename not specified after <CODE>-o</CODE>.</TD>
70    <TR>
71      <TD align=center width="20">5</TD>
72<TD width="400">Symbol list filename not specified after <CODE>-s</CODE>.</TD>
73    </TR>
74    <TR>
75      <TD align=center width="20">6</TD>
76<TD width="400">Template filename not specified after <CODE>-t</CODE>.</TD>
77    </TR>
78    <TR>
79      <TD align=center width="20">7</TD>
80<TD width="400">Template file read failed.</TD>
81    </TR>
82    <TR>
83      <TD align=center width="20">8</TD>
84<TD width="400">File output error.</TD>
85    </TR>
86    <TR>
87      <TD align=center width="20">9</TD>
88<TD width="400">Unspecifiable option.</TD>
89    </TR>
90    <TR>
91      <TD align=center width="20">10</TD>
92<TD width="400">Too many arguments specified (2048 maximum).</TD>
93    </TR>
94    <TR>
95      <TD align=center width="20">11</TD>
96<TD width="400">Response file read failed.</TD>
97    </TR>
98     <TR>
99      <TD align=center width="20">12</TD>
100<TD width="400">Abnormally long filename specified.</TD>
101    </TR>
102    <TR>
103      <TD align=center width="20">13</TD>
104<TD width="400">Allocation of conversion memory failed.</TD>
105    </TR>
106  </TBODY>
107</TABLE>
108
109<H2>Example</H2>
110<p>
111This example demonstrates creation of the static module's linker command file (<code>static.lcf</code>) and symbol list (<code>symbol.lst</code>) from all dynamic module files (<code>a.rso, b.rso</code>) and the linker command template (<CODE>eppc.RVL0.lcf</CODE>).<br>
112
113</p>
114<TABLE border="1" width="95%">
115  <TBODY>
116    <TR>
117      <TD width="100%">
118      <PRE><CODE>
119% makelcf.exe -o static.lcf -s symbol.lst -t eppc.RVL.lcf a.rso b.rso
120</CODE></PRE>
121      </TD>
122    </TR>
123  </TBODY>
124</TABLE>
125<p>
126If using a response file (<code>response.txt</code>), do so as follows:
127</p>
128<TABLE border="1" width="95%">
129  <TBODY>
130    <TR>
131      <TD width="100%">
132      <PRE><CODE>
133% makelcf.exe @response.txt
134</CODE></PRE>
135      </TD>
136    </TR>
137  </TBODY>
138</TABLE>
139<p>
140The <code>response.txt</code> example for the above.<br>
141</p>
142<TABLE border="1" width="95%">
143  <TBODY>
144    <TR>
145      <TD width="100%">
146      <PRE><CODE>
147-o static.lcf -s symbol.lst -t eppc.RVL.lcf a.rso b.rso
148</CODE></PRE>
149      </TD>
150    </TR>
151  </TBODY>
152</TABLE>
153
154<H2>See Also</H2>
155<p>
156<a href="./tools.html">Tool List</a>
157</p>
158
159<H2>Revision History</H2>
160<p>
1612006/11/01 Added support for return values.<br>2006/10/27 Added support for response files.<br>2006/10/25 Added support for multiple files.<br> 2006/06/14 Initial version.<br>
162</p>
163
164<hr><p>CONFIDENTIAL</p></body>
165</HTML>
166