# nitrorun.TWL

## Description

This command is for TWL ROMs. See `nitrorun` for details on NITRO ROMs.

The `nitrorun.TWL` script executes the following series of operations: starting `buryarg.TWL` and `loadrun.TWL`, passing arguments from the command line, overwriting the argument region of the SRL file, downloading the data to IS-TWL-DEBUGGER and/or another device, and executing the code.

Specifically:

> `buryarg.TWL --stdout ... > temporaryFile
> loadrun.TWL ... temporaryFile`

This will call `buryarg.TWL` and `loadrun.TWL` in sequence. With `nitrorun`, these commands were joined with pipes, but with TWL, a different method is used to load SRL files in the debugger, so the original method cannot be used. As a result, we have broken it into two commands.

The reasons that the command name "`nitrorun.TWL`" is used even though this command is run on TWL ROMs are (1) to match the `nitrorun` command that has been around since the former NITRO-SDK, and (2) to follow the command-naming convention wherein ".TWL" is added to indicate that the command is for TWL.

## Using the Tool

### Start Command

`% nitrorun.TWL [OPTION]... [[TWLSRLFILE] [ARGUMENT]...]`

`TWLSRLFILE` is the ROM file to execute. You can specify SRL files.

The `-h` or `--help` option displays simple instructions.

The `--bopt` option specifies options to be passed to the `buryarg.TWL` command. However, the `--stdin` option does not need to be described because it will be attached in advance.

The `--lopt` option specifies options to be passed to the `loadrun.TWL` command.

If the `-v` or `--verbose` option is specified, detailed operation descriptions are displayed.

Specifying the `-n` or `--noexec` option does not execute the command. When used in conjunction with the `-v` option, you can check which type of command will be executed.

The `--version` option displays the command version.

Example 1

> `nitrorun.TWL main.srl 100 300`

> executes the following commands.

> `buryarg.TWL --stdout main.srl 100 300 > tmpFile
> loadrun.TWL tmpFile`

Example 2

> `nitrorun.TWL --bopt "-f rep.dat" --lopt "-t 300 -a \"ABORT\" " main.srl 100 300`

> executes the following commands.

> `buryarg.TWL --stdout -f rep.dat main.srl 100 300 > tmpFile
> loadrun.TWL -t 300 -a "ABORT" tmpFile`

> ``

## Location

`$TwlSDK/tools/bin/nitrorun.TWL`

## See Also

`buryarg.TWL`
`loadrun.TWL`
`nitrorun`

## Revision History

2008/07/10 Initial version.

CONFIDENTIAL