ilrun - the Portable.NET runtime engine

ilrun [ options ] program [ program-options ]

Ilrun loads and executes the Intermediate Language (IL) program, passing it the supplied program-options. For example:

ilrun hello.exe

If the IL program has command-line options, they can be supplied after the name of the IL executable:

ilrun getenv.exe PATH

The "mscorlib.dll" file should either be placed in the same directory as the program you are running, or in the system-wide location "PREFIX/lib/cscc/lib", where "PREFIX" is the directory where you installed Portable.NET (e.g. "/usr/local").

--heap-size num, -H num

Set the size of the heap to num kilobytes. By default, the heap is unlimited in size.

--stack-size num, -S num

Set the size of the operation stack to num kilobytes. By default, the stack is 8k in size.

--library-dir dir, -L dir

Add dir to the list of directories to be searched for libraries that are referenced by the application.

--register [path] Linux kernel only: register ilrun with the kernel so that it will be run automatically when IL binaries are executed. See the section "USING ILRUN WITH THE LINUX KERNEL" below for more information.

--unregister

Linux kernel only: unregister ilrun from the kernel.

--method-profile, -M

Display how many times each method was called on exit.

--trace, -T

Trace every method call or return.

--dump-config, -D

Dump configuration information for the engine. -DD will dump even more information.

--help

Print a usage message for the ilrun program.

-v, --version

Print the version of the ilrun program.

--

Marks the end of the command-line options, and the beginning of the input filenames. You may need to use this if your program filename begins with '-'. e.g. "ilrun -- -input.exe".

If your operating system uses the Linux kernel, and you have root access, then you can avoid typing ilrun to execute programs from the command-line.

You must first register ilrun with the Linux kernel, by executing the following command as root:

 ilrun --register

 chmod +x hello.exe
 ./hello.exe

To unregister ilrun, execute the following command as root:

 ilrun --unregister

When you register ilrun, it attempts to construct the full path of the engine to pass to the kernel. Normally it does this by searching the PATH. You can specify an explicit pathname as follows:

 ilrun --register /usr/local/bin/ilrun

Because IL programs have a similar format to regular PE/COFF Windows executables, it is not always clear whether a program should be executed with ilrun or with wine.

If you pass a regular Windows executable to ilrun, it will hand off control to wine to run the program. It uses the first executable called wine on the PATH.

If your Wine installation is not on the PATH, you can set the WINE environment variable to specify its location.

Wine also has facilities for registering itself with the Linux kernel to run PE/COFF executables. Only one PE/COFF handler can be registered at a time. It is important that ilrun be registered as the primary PE/COFF handler, because Wine does not currently know how to hand off IL programs to ilrun.

Written by Southern Storm Software, Pty Ltd.

http://www.southern-storm.com.au/

ilasm(1), ildasm(1), cscc(1)

Exit status is 1 if an error occurred while processing the input. Otherwise the exit status is 0.

wine: No such file or directory

The ilrun program was passed a regular Windows PE/COFF executable that did not contain IL data. The engine attempted to hand the program off to wine for execution, but wine was not found.