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 &lt;Symbol List&gt;</H3>
38<p>
39This 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>
40</p>
41<H3>-a</H3>
42<p>
43This option makes the debug file position information an absolute path.<br>
44</p>
45<H3>@&lt;Response File&gt;</H3>
46<p>
47You can also configure and specify the arguments through a 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 that does not fall under 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 maximum).</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 filename 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="95%">
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="95%">
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>
150If using a response file (<code>response.txt</code>), do so as follows:
151</p>
152<TABLE border="1" width="95%">
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="95%">
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="95%">
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
193<H2>See Also</H2>
194<p>
195<a href="./tools.html">Tool List</a>
196</p>
197
198<H2>Revision History</H2>
199<p>
2002006/11/01 Added support for return values.<br>
2012006/10/27 Added support for response files.<br>
2022006/10/25 Added support for multiple files.<br>
2032006/06/14 Initial version.<br>
204</p>
205
206<hr><p>CONFIDENTIAL</p></body>
207</HTML>
208