Added a readme to the uml target for a quick start
[openwrt.git] / target / linux / uml-2.6 / README
1 Openwrt inside a user mode linux.  Why would we even want this many ask?
2
3 There are potentially a lot of reasons, one obvious one to me, it allows
4 folks to 'kick the tires' without actually flashing up any hardware.  It's
5 also a great environment for porting over packages, you can get a package
6 fully functional in the uclibc root environment inside a uml without actually
7 disturbing your 'real router', and then rebuild for a specific target once
8 it's fully tested.
9
10 This is a first stab at a build that 'just works' and there will be more
11 cleanup to come.  The simple directions are:-
12
13 Configure for uml target
14 Configure with an ext2 root file system
15 build it all
16
17 In your bin directory you will find a kernel and an ext2 root file system
18 when it's finished.  Just run it like this:-
19
20 bin/openwrt-uml-2.6-vmlinux ubd0=bin/openwrt-uml-2.6-ext2.img
21
22 The uml will start, and bring up an xterm with the serial console in it.  No
23 networking is configured, but, it's a starting point.  The resulting file system
24 has just enough free space to start kicking the tires and playing in the world of
25 'embedded routers' along with all the resource restrictions that come with that
26 world.  
27
28 To configure networking and more, refer to the user mode linux documentation online
29
30 http://user-mode-linux.sourceforge.net/