1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>nitrorun</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9<STYLE type="text/css">
10<!--
11.sample_source{
12  background-color : #e8e8e8;
13}
14H3{
15  color : teal;
16}
17.command_list{
18  margin-bottom : 16pt;
19}
20.command_desc{
21  }
22.command_item{
23  margin-top : 16pt;
24  background-color : #e8e8e8;
25}
26.blockquoted_table {
27  border : 1px;
28  width : 80%;
29}
30TD,TH{
31  border-color	: #c0d8d8;
32  padding       : 1pt 4pt 1pt 4pt;
33  border-width  : 1px;
34  border-style  : solid;
35}
36-->
37</STYLE>
38</HEAD>
39<BODY>
40<H1 align="left">nitrorun <IMG src="../image/NTR.gif" align="middle"></H1>
41<H2>Description</H2>
42<P><FONT color=#ff0000>This command is for NITRO ROMs. See <CODE><A href="nitrorunTWL.html">nitrorun.TWL</A></CODE> for details on TWL ROMs.</FONT></P>
43<P> <CODE>nitrorun</CODE> is a script for executing the following series of operations: starting <CODE><A href="buryarg.html">buryarg</A></CODE> and <CODE><A href="loadrun.html">loadrun</A></CODE>, passing arguments from the command line, rewriting the argument region of the srl file, downloading the data to the IS-NITRO-EMULATOR and such, and executing the code.</P>
44<P>Specifically:</P>
45<BLOCKQUOTE><CODE>buryarg --stdout ... | loadrun --stdin</CODE></BLOCKQUOTE>
46<P><CODE><A href="buryarg.html">buryarg</A></CODE> and <CODE><A href="loadrun.html">loadrun</A></CODE> are connected by a pipe, and <CODE><A href="buryarg.html">buryarg</A></CODE> writes to the standard output while <CODE><A href="loadrun.html">loadrun</A></CODE> reads from the standard input.</P>
47<H2>Using the Tool</H2>
48<H3>Start Command</H3>
49<P><CODE>% nitrorun [OPTION]... [[NITROSRLFILE] [ARGUMENT]...]</CODE></P>
50<P><CODE>NITROSRLFILE</CODE> is the ROM file to execute. <CODE>.srl</CODE> files can be specified.</P>
51<P>The <CODE><B>-h</B></CODE> or  <CODE><B>--help</B></CODE> options display simple instructions.</P>
52<P>The <B><CODE>--bopt</CODE></B> option specifies options to be passed to the <CODE><A href="buryarg.html">buryarg</A></CODE> command. However, the <CODE>--stdin</CODE> option does not need to be described because it will be attached in advance.</P>
53<P>The <B><CODE>--lopt</CODE></B> option specifies options to be passed to the <CODE><A href="loadrun.html">loadrun</A></CODE> command. However, the <CODE>--stdin</CODE> option does not need to be described because it will be attached in advance.</P>
54<P>If the <CODE><B>-v</B></CODE> or <CODE><B>--verbose</B></CODE> option is specified, detailed operation descriptions are displayed. </P>
55<P>Specifying the <CODE><B>-n</B></CODE> or <CODE><B>--noexec</B></CODE> option does not execute the command. When used in conjunction with the <CODE>-v</CODE> option, you can check which type of command will be executed.</P>
56<P>The <CODE><B>--version</B></CODE> option displays the command version.</P>
57<P><B><BR> <BR> <BR> (Example 1)</B></P>
58<BLOCKQUOTE><CODE>nitrorun  <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT></CODE></BLOCKQUOTE>
59<BLOCKQUOTE>will cause the following command to execute.</BLOCKQUOTE>
60<BLOCKQUOTE><CODE><A href="buryarg.html">buryarg</A> --stdout <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT> | <A href="loadrun.html">loadrun</A> --stdin</CODE></BLOCKQUOTE>
61<BLOCKQUOTE>  </BLOCKQUOTE>
62<P><B>(Example 2)</B></P>
63<BLOCKQUOTE><CODE>nitrorun --bopt&#x3000;&quot;<FONT color="#00cc66">-f rep.dat</FONT>&quot; --lopt &quot;<FONT color="#ff0033">-t 300 -a \&quot;ABORT\&quot;</FONT> &quot; <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT></CODE></BLOCKQUOTE>
64<BLOCKQUOTE>will cause the following command to execute.</BLOCKQUOTE>
65<BLOCKQUOTE><CODE><A href="buryarg.html">buryarg</A> --stdout <FONT color="#00cc66">-f rep.dat</FONT> <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT> | <A href="loadrun.html">loadrun</A> --stdin <FONT color="#ff0033">-t 300 -a &quot;ABORT&quot;</FONT></CODE></BLOCKQUOTE>
66<BLOCKQUOTE><CODE>  </CODE></BLOCKQUOTE>
67<H2>Location</H2>
68<P><CODE>$TwlSDK/tools/bin/nitrorun</CODE></P>
69<H2>See Also</H2>
70<P><CODE><A href="buryarg.html">buryarg</A>, <A href="loadrun.html">loadrun</A>, <A href="nitrorunTWL.html">nitrorun.TWL</A></CODE></P>
71<H2>Revision History</H2>
72<P>2005/08/31 Initial version.</P>
73<hr><p>CONFIDENTIAL</p></body>
74</HTML>