Quick start
-----------

In order to run umlrun, you must prepare a UML root filesystem which
has umlrun-uml installed.  The easiest way to do this is typically
with rootstrap, especially if you will be doing it multiple times, but
any root filesystem should work fine.

1. apt-get install rootstrap

2. Edit /etc/rootstrap/rootstrap.conf

   2.1 Configure networking parameters, etc.

   2.2a If building a release which includes umlrun-uml (currently
        only unstable), it can be automatically installed by adding
        the following to rootstrap.conf:

         [debian]
         include=umlrun-uml

   2.2b Otherwise, install umlrun-uml's dependencies so that it can be
        installed easily by hand.  Currently, this is only Python, but
        check the latest umlrun-uml package to be sure.

         [debian]
         include=python

3. rootstrap umlrun.ext2

4. If umlrun-uml could not be automatically installed, install it by hand:

   4.1 Downoad umlrun-uml.deb into /tmp on host

   4.2 linux ubd0=umlrun.ext2

   4.3 [within UML]
       mount -t hostfs hostfs /mnt
       dpkg -i /mnt/tmp/umlrun-uml.deb

   4.4 halt

To execute a command within UML:

umlrun --umlargs "...<UML options>..." <commands>

For example:

umlrun --umlargs "ubd0=umlrun.ext2 eth0=slirp" apt-get install build-essential
