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