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