1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
4<meta http-equiv="Content-Style-Type" content="text/css">
5<title>ctr_makecia</title>
6<style type="text/css">
7<!--
8body {
9/*
10    font-size       : 10pt;
11*/
12    font-weight     : normal;
13    color           : #000000;
14    margin          : 8px;
15}
16
17div {
18    width           : 98%;
19    white-space     : nowrap;
20}
21
22div.title {
23    text-align      : left;
24    font-weight     : bold;
25/*
26    font-size       : 16pt;
27*/
28    font-size       : 150%;
29    color           : #202020;
30    border-style    : double;
31    border-width    : 8px;
32    /* タイトルを囲む枠線の色を指定 */
33    border-color    : #CD202C;
34
35    /* RVLプラットフォーム系列 */
36/*
37    border-color    : #34beed;
38*/
39
40    /* TWLプラットフォーム系列 */
41/*
42    border-color    : #ff458f;
43*/
44
45    margin          : 4px;
46    padding         : 4px;
47}
48H1 {
49  font-size		: 150%;
50  font-family		: Arial;
51  border-bottom-width	: 5px;
52  border-bottom-style	: solid;
53  border-bottom-color	: #CD202C;
54  padding-bottom		: 1px;
55  margin-bottom		: 20px;
56  letter-spacing		: normal;
57  font-weight		: bold;
58}
59
60h2 {
61    font-weight     : bold;
62/*
63    font-size       : 16pt;
64*/
65    font-size       : 150%;
66    border-style    : none none solid double;
67    border-width    : 0px 0px 2px 8px;
68    /* 見出しの線の色を指定 */
69    border-color    : #CD202C;
70
71    /* RVLプラットフォーム系列 */
72/*
73    border-color    : #34beed;
74*/
75
76    /* TWLプラットフォーム系列 */
77/*
78    border-color    : #ff458f;
79*/
80
81    margin-left     : 2px;
82    padding-left    : 4px;
83}
84CODE {
85  font-family		: "Courier New", monospace;
86  position		: normal;
87  left			: 12px;
88  font-size		: 10pt;
89}
90table {
91  margin-top        : 2pt;
92  margin-bottom     : 2pt;
93  margin-left       : 0pt;
94  margin-right      : 0pt;
95  padding-left      : 0pt;
96  padding-right     : 0pt;
97  position          : relative;
98  left              : 12px;
99  font-family       : Arial;
100  font-size         : 10pt;
101  border-style      : none none none none;
102}
103td,th {
104  padding           : 2pt;
105  border-width      : 2pt;
106  border-style      : none none none none;
107  font-style        : normal;
108  text-align        : left;
109}
110td {
111  background        : #e8f4f4;
112  font-weight       : normal;
113}
114th {
115  background        : #c0d8d8;
116  font-weight       : bold;
117}
118
119p {
120    margin-left     : 4px;
121}
122p.code {
123  font-family		: "Courier New", monospace;
124  position		: normal;
125  left			: 12px;
126  font-size		: 10pt;
127  background            : #e8f4f4;
128}
129
130-->
131</style>
132
133</head>
134<body>
135<a name="top"></a>
136
137<h1>ctr_makecia</h1>
138
139<h2>Description</h2>
140<P>
141This <CODE>ctr_makecia</CODE> tool is for creating CIA (CTR Importable Archive) files. This tool generates CIA files that can be imported via <A href="../ctools/DevMenu.html">DevMenu</A> from CXI files, which are the executable images of imported applications.<br/>CIA files that can be imported to CTR can also be generated from the SRL files used for TWL NAND applications.
142</P>
143<P>
144You can create CIA files of data titles storing add-on content. To read details about the creation of these data title CIA files, see the <CODE>E-Commerce Kit</CODE> documentation.
145</P>
146
147<h2>How to Use</h2>
148<h3>What's Required</h3>
149<p>The following files are required to generate CIA files for imported applications.</p>
150<ul>
151<li> CXI files that are executable images of imported applications, generated by <A href="ctr_makerom.html"><CODE>ctr_makerom</CODE></A>
152<li> CFA files that are manual content archives generated by <A href="ctr_makerom.html"><CODE>ctr_makerom</CODE></A>
153</ul>
154or
155<ul>
156<li> CCI files, which are manual content archives generated by <A href="ctr_makerom.html"><CODE>ctr_makerom</CODE></A>
157</ul>
158
159<p>The following files are required in order to generate CIA files from TWL NAND applications.</p>
160<ul>
161<li> TWL NAND application SRL file generated using TWL-SDK
162</ul>
163
164<h3>Command</h3>
165
166<h4>Generate CIA files for imported applications</h4>
167
168When created from CXI and CFA files
169<p class="code">
170% ctr_makecia32 -i CXI_FILE -o CIA_FILE [-man MANUAL_CFA_FILE]
171</p>
172
173When created from a CCI file
174<p class="code">
175% ctr_makecia32 -cci CCI_FILE -o CIA_FILE
176</p>
177
178
179<p class="first_ja">
180When generating CIA files for CTR imported applications, you must specify <CODE>CXI_FILE</CODE> and <CODE>CIA_FILE</CODE>.<br/>If the <CODE>MANUAL_CFA_FILE</CODE> option is not specified, a CIA file without a manual is generated.
181</p>
182
183<h4>Generate CIA files from TWL NAND application SRL files</h4>
184
185<p class="code">
186% ctr_makecia32 -srl SRL_FILE -o CIA_FILE
187</p>
188
189<p class="first_ja"> When generating CIA files from a TWL NAND application SRL file, you must specify <CODE>SRL_FILE</CODE> and <CODE>CIA_FILE</CODE>.
190
191<h4 >Options</h4>
192
193<div class="table">
194<table border="1" summary="options">
195<thead>
196<tr>
197<th align="center">Options</th>
198<th align="center">Description</th>
199</tr>
200</thead>
201<tbody>
202<tr>
203<td align="center">-i</td>
204<td align="center">Specifies the input CXI file.</td>
205</tr>
206<tr>
207<td align="center">-i CONTENTS_PATH:INDEX</td>
208<td align="center">
209Specifies content included in the CIA file.<BR> Specify the content file path in <CODE>CONTENTS_PATH</CODE>.<BR> <CODE>INDEX</CODE> specifies the index number that contains this content. There is a predetermined <CODE>INDEX</CODE> to specify for each type of content.<br/>Only specify <CODE>0</CODE> for a CXI file storing an executable image of an imported application.<br/>Only specify <CODE>1</CODE> for a CFA file storing an e-manual.<br/>Only specify <CODE>2</CODE> for a CFA file storing a download-play child program.<br/>You must not specify any other values.<br/> Refer to the documentation corresponding to each type of content for details.</td>
210</tr>
211<tr>
212<td align="center">-o</td>
213<td align="center">Specifies the output CIA file.</td>
214</tr>
215<tr>
216<td align="center">-cci</td>
217<td align="center">Converts from CCI to CIA. This cannot be used at the same time as options other than <CODE>-o</CODE>.</td>
218</tr>
219<tr>
220<td align="center"><CODE>-srl</CODE></td>
221<td align="center">Specify the SRL file built as the TWL NAND application. The <CODE>-srl</CODE> option cannot be specified concurrently with the <CODE>-i</CODE> and <CODE>-man</CODE> options.</td>
222</tr>
223<tr>
224<td align="center"><CODE>-man</CODE></td>
225<td align="center">Specifies the CFA file for the manual.</td>
226</tr>
227<tr>
228<td align="center">-datatitle-version</td>
229<td align="center">Specifies the version of the data title. This can only be used when creating a data title.</td>
230</tr>
231<tr>
232<td align="center">-content-list</td>
233<td align="center">Specifies the content list file for a data title. This can only be used when creating a data title.</td>
234</tr>
235
236</tbody>
237</table>
238</div>
239
240<h2>Variables Defined Within OMakefiles</h2>
241<p>
242See <A href="../SDKRules/BuildRules.html">Build Rules</A> for more information about the variables defined in <CODE>OMakefile</CODE>.
243</p>
244
245<h2>Revision History</h2>
246    <dl class="history">
247      <dt>2012/04/16</dt>
248<dd>Added the &quot;-i CONTENTS_PATH:INDEX&quot; option for specifying the content included in a CIA file.<br />
249      <dt>2011/03/16</dt>
250<dd>Added the &quot;-cci&quot; option for converting from CCI to CIA.<br />
251      <dt>2011/12/16</dt>
252<dd>Added descriptions of options used when creating data titles.<br />
253      <dt>2011/03/22</dt>
254<dd>Described how to generate CIA files that include manuals and how to generate CIA files from TWL NAND applications.<br />
255      <dt>2010/07/14</dt>
256<dd>Initial version.<br />
257      </dd>
258    </dl>
259<hr><p>CONFIDENTIAL</p></body>
260</html>