mirror of
https://git.openwrt.org/openwrt/openwrt.git
synced 2024-06-20 15:48:26 +02:00
841738aa55
The current `uml` README is terribly outdated and non of the examples work by default. Fix that and while at it convert it to Markdown. Signed-off-by: Paul Spooren <mail@aparcar.org>
52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# OpenWrt inside a user mode linux
|
|
|
|
> Why would we even want this many ask?
|
|
|
|
There are potentially a lot of reasons, one obvious one to me, it allows folks
|
|
to 'kick the tires' without actually flashing up any hardware. It's also a
|
|
great environment for porting over packages, you can get a package fully
|
|
functional in the uclibc root environment inside a uml without actually
|
|
disturbing your 'real router', and then rebuild for a specific target once it's
|
|
fully tested.
|
|
|
|
This is a first stab at a build that 'just works' and there will be more
|
|
cleanup to come. The simple directions are:-
|
|
|
|
* Configure for uml target
|
|
* Configure with an ext4 or squashfs root file system
|
|
* Build it all
|
|
|
|
In your bin directory you will find a Kernel and an root file system when it's
|
|
finished. Just run it like this:-
|
|
|
|
```shell
|
|
./openwrt-uml-vmlinux ubd0=openwrt-uml-squashfs.img
|
|
```
|
|
|
|
The uml will start and eventually the serial console of the uml will be at your
|
|
console prompt. If you would like it in xterms, substitute `con=xterm` and
|
|
`con0=xterm`. **No networking is configured** but it's a starting point. The
|
|
resulting file system has just enough free space to start kicking the tires and
|
|
playing in the world of 'embedded routers' along with all the resource
|
|
restrictions that come with that world.
|
|
|
|
To configure networking and more refer to the *user mode linux* documentation
|
|
online. A quick start goes along this line. Install the `uml-utilities`
|
|
packages so you have the `uml_switch` in and running, then add a command param
|
|
to your uml start like this:
|
|
|
|
```shell
|
|
eth0=daemon,00:01:01:01:01:01,unix,/<your uml switch control socket here>
|
|
```
|
|
|
|
With that in, and uml networking actually functional (can be a challenge at
|
|
times), you should be able to `ifconfig` the interface and talk to the host
|
|
side or if you bridged the uml switch to your host network, you should be able
|
|
to run `udhcp` and be away with networking off to the world. Again, if you are
|
|
unfamiliar with uml and uml networking, please read the docs and how-to stuff
|
|
available on the net. It does take some fiddling to get it started and working
|
|
right the first time, but after that, it opens up a whole new world of virtual
|
|
machines.
|
|
|
|
http://user-mode-linux.sourceforge.net/
|