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 "<FONT color="#00cc66">-f rep.dat</FONT>" --lopt "<FONT color="#ff0033">-t 300 -a \"ABORT\"</FONT> " <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 "ABORT"</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>