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>makerso.exe</title>
9</head>
10
11<body>
12
13<H1>makerso.exe</H1>
14
15<H2>Location</H2>
16<p><code>$REVOLUTION_SDK_ROOT/X86/bin/</code></p>
17
18<H2>Overview</H2>
19<p>
20Creates module files (<code>.sel, .rso</code>) from elf files (<code>.elf, .plf</code>).
21</p>
22
23<H2>Description</H2>
24<p>
25Creates module files usable by relocatable modules from elf files.
26</p>
27<p>
28Dynamic (relocatable) module information (<code>.rso</code>) will include code information, section information, export information (information to allow referencing from external modules), import information (information for referencing external modules), and internal referencing information.
29</p>
30<p>
31Static module information (<code>.sel</code>) will include dummy section information and export information.
32</p>
33<p>
34Distinction between static and dynamic will be made from information in the elf file.
35</p>
36<H2>Options</H2>
37<H3>-e (Symbol List)</H3>
38<p>
39Referenced when creating export information, this removes information other than the specified symbols. <br>Only one symbol list may be specified.<br>When omitted, the file includes all information.<br>
40</p>
41<H3>-a</H3>
42<p>
43The debug file position information becomes the absolute path.<br>
44</p>
45<H3>@ (Response File)</H3>
46<p>
47The arguments can be configured through the response file (which lists the arguments).
48</p>
49<H2>Return Value</H2>
50<TABLE border="1">
51  <TBODY>
52    <TR>
53      <TD align=center width="20">0</TD>
54<TD width="400">Conversion successful.</TD>
55    </TR>
56    <TR>
57      <TD align=center width="20">1</TD>
58<TD width="400">An error not included in the following errors:</TD>
59    </TR>
60    <TR>
61      <TD align=center width="20">2</TD>
62<TD width="400"><CODE>-a</CODE>: Conversion to absolute path by specification failed.</TD>
63    </TR>
64    <TR>
65      <TD align=center width="20">3</TD>
66<TD width="400">Reading of symbol list specified by <CODE>-e</CODE> failed.</TD>
67    </TR>
68    <TR>
69      <TD align=center width="20">4</TD>
70<TD width="400">Multiple symbol lists were specified.</TD>
71    <TR>
72      <TD align=center width="20">5</TD>
73<TD width="400">Symbol file name not specified after <CODE>-e</CODE>.</TD>
74    </TR>
75    <TR>
76      <TD align=center width="20">6</TD>
77<TD width="400">No ELF file specified.</TD>
78    </TR>
79    <TR>
80      <TD align=center width="20">7</TD>
81<TD width="400">ELF file read failed.</TD>
82    </TR>
83    <TR>
84      <TD align=center width="20">8</TD>
85<TD width="400">Unsupported ELF file.</TD>
86    </TR>
87    <TR>
88      <TD align=center width="20">9</TD>
89<TD width="400">Duplicate ELF file specified.</TD>
90    </TR>
91    <TR>
92      <TD align=center width="20">10</TD>
93<TD width="400">File output failed.</TD>
94    </TR>
95    <TR>
96      <TD align=center width="20">11</TD>
97<TD width="400">Unspecifiable option.</TD>
98    </TR>
99    <TR>
100      <TD align=center width="20">12</TD>
101<TD width="400">Too many arguments specified (2048 max.).</TD>
102    </TR>
103    <TR>
104      <TD align=center width="20">13</TD>
105<TD width="400">Response file read failed.</TD>
106    </TR>
107     <TR>
108      <TD align=center width="20">14</TD>
109<TD width="400">Abnormally long file name specified.</TD>
110    </TR>
111    <TR>
112      <TD align=center width="20">15</TD>
113<TD width="400">Allocation of conversion memory failed.</TD>
114    </TR>
115    </TR>
116  </TBODY>
117</TABLE>
118<H2>Examples</H2>
119<p>
120This example creates a dynamic (relocatable) module file from the partially linked elf files. <code>a.rso</code> will be generated.<br>
121</p>
122<p>
123When <code>symbol.lst</code> is specified, information for allowing referencing from external modules will be omitted.<br>Since the dynamic module symbol list cannot be auto-generated at this point, it must be manually created.<br>Register labels to be referenced from other modules in <code>symbol.lst</code>.
124</p>
125<TABLE border="1" width="100%">
126  <TBODY>
127    <TR>
128      <TD width="100%">
129      <PRE><CODE>
130% makerso.exe a.plf [-e symbol.lst]</CODE></PRE>
131      </TD>
132    </TR>
133  </TBODY>
134</TABLE>
135
136<p>
137Multiple files may be specified.<br>An <code>.rso</code> file is created for each specified file.<br>The <code>a.rso</code>, <code>b.rso</code>, and <code>c.rso</code> files are created in the following example:
138</p>
139<TABLE border="1" width="100%">
140  <TBODY>
141    <TR>
142      <TD width="100%">
143      <PRE><CODE>
144% makerso.exe a.plf b.plf c.plf [-e symbol.lst]</CODE></PRE>
145      </TD>
146    </TR>
147  </TBODY>
148</TABLE>
149<p>
150Use the response file (<code>response.txt</code>) as follows:
151</p>
152<TABLE border="1" width="100%">
153  <TBODY>
154    <TR>
155      <TD width="100%">
156      <PRE><CODE>
157% makerso.exe @response.txt </CODE></PRE>
158      </TD>
159    </TR>
160  </TBODY>
161</TABLE>
162<p>
163The <code>response.txt</code> example for the above case:<br>
164</p>
165<TABLE border="1" width="100%">
166  <TBODY>
167    <TR>
168      <TD width="100%">
169      <PRE><CODE>
170a.plf b.plf c.plf [-e symbol.lst]
171      </TD>
172    </TR>
173  </TBODY>
174</TABLE>
175<p>
176This example generates static module information from the static ELF file. <code>static.sel</code> will be generated.<br>
177</p>
178<p>
179Static module symbol list is generated using <code><a href="./makelcf.html">makelcf.exe</a></code> from all dynamic modules.<br>
180</p>
181<TABLE border="1" width="100%">
182  <TBODY>
183    <TR>
184      <TD width="100%">
185      <PRE><CODE>
186% makerso.exe static.elf -e symbol.lst
187</CODE></PRE>
188      </TD>
189    </TR>
190  </TBODY>
191</TABLE>
192<H2>See Also</H2>
193<p><a href="./tools.html">Tool List</a></p>
194
195<H2>Revision History</H2>
196<p>
1972006/06/14 Initial version. <BR>
1982006/10/25 Added support for multiple files.<br>
1992006/10/27 Added support for response files.<br>
2002006/11/01 Added support for return values.<br>
201</p>
202<hr><p>CONFIDENTIAL</p></body>
203</HTML>
204