= MSIM =
{{{
/app/msim
}}}

[http://d3s.mff.cuni.cz/~holub/sw/msim/ MSIM] is a computer simulator
based on MIPS R4000. HelenOS mips32-msim target runs on MSIM and, since MSIM
now runs on HelenOS, you can run HelenOS within HelenOS.

== Running HelenOS in HelenOS ==

You need to configure your HelenOS build to include MSIM. You also need to transfer
a mips32-msim boot image (e.g.
[http://www.helenos.org/releases/HelenOS-0.5.0-mips32-msim.boot this one])
and MSIM configuration file
[http://trac.helenos.org/export/current%3A/mainline/contrib/conf/msim.conf msim.conf]
onto the system. Either add them under `uspace/dist` before building the system,
or mount them from a disk / virtual disk image (when running in an emulator).

Within HelenOS, change to the directory that contains `msim.conf` and the system image
and run `msim`. (It can take a while to boot.)