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 static module linker command file and symbol list 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 linker command file and symbol list of the static module.<br>Specifically, this collects the export symbol information and outputs after removing symbols from duplicate and import information.<br> 26</p> 27<p> 28The symbol list is used to generate a module file (<code>.sel</code>) of static module.(See <code><a href="./makerso.html">makerso.exe</a></code>) 29</p> 30 31<H2>Options</H2> 32<H3>-o (Linker Command File)</H3> 33<p> 34Specifies the name of the output linker command file.<br>When this is omitted, the output file name is <code>static.lcf</code>. 35</p> 36<H3>-s (Symbol List)</H3> 37<p> 38Specifies the file name of the output symbol list.<br>When this is omitted, the output file name is <code>symbol.lst</code>. 39</p> 40<H3>-t (Linker Command File Template)</H3> 41<p> 42Specifies the template for the linker command file.<br>Specify <CODE><revolution/eppc.$(PLATFORM).lcf></CODE>.<br>This cannot be omitted. 43</p> 44<H3>@ (Response File)</H3> 45<p> 46The arguments can be configured through the response file (which lists the arguments). 47</p> 48<H2>Return Value</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 not included in 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 file name not specified after <CODE>-o</CODE>.</TD> 70 <TR> 71 <TD align=center width="20">5</TD> 72<TD width="400">Symbol list file name not specified after <CODE>-s</CODE>.</TD> 73 </TR> 74 <TR> 75 <TD align=center width="20">6</TD> 76<TD width="400">Template file name 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 max.).</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 file name 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 </TR> 107 </TBODY> 108</TABLE> 109<H2>Example</H2> 110<p> 111This example creates static module 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="100%"> 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> 126Use the response file (<code>response.txt</code>) as follows: 127</p> 128<TABLE border="1" width="100%"> 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="100%"> 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<H2>See Also</H2> 154<p><a href="./tools.html">Tool List</a></p> 155<H2>Revision History</H2> 156<p> 1572006/06/14 Initial version. <BR>2006/10/25 Added support for multiple files.<br> 2006/11/01 Added support for return values.<br> 158</p> 159<hr><p>CONFIDENTIAL</p></body> 160</HTML> 161