aboutsummaryrefslogtreecommitdiffstats
path: root/target/linux/uml-2.6/README
diff options
context:
space:
mode:
authorGerry Rozema <gerryr@rozeware.com>2006-07-22 01:48:29 +0000
committerGerry Rozema <gerryr@rozeware.com>2006-07-22 01:48:29 +0000
commit2a5cd294b0f2ed6a462695cbf800b1855432f2df (patch)
treef72a9a4ae06c8f3f65594581f617df972bc085d5 /target/linux/uml-2.6/README
parent2fc006565bcdda2443b11f28dbdaaacbca4dd2ba (diff)
downloadupstream-2a5cd294b0f2ed6a462695cbf800b1855432f2df.tar.gz
upstream-2a5cd294b0f2ed6a462695cbf800b1855432f2df.tar.bz2
upstream-2a5cd294b0f2ed6a462695cbf800b1855432f2df.zip
Added a readme to the uml target for a quick start
git-svn-id: svn://svn.openwrt.org/openwrt/branches/buildroot-ng/openwrt@4202 3c298f89-4303-0410-b956-a3cf2f4a3e73
Diffstat (limited to 'target/linux/uml-2.6/README')
-rw-r--r--target/linux/uml-2.6/README30
1 files changed, 30 insertions, 0 deletions
diff --git a/target/linux/uml-2.6/README b/target/linux/uml-2.6/README
new file mode 100644
index 0000000000..b014830921
--- /dev/null
+++ b/target/linux/uml-2.6/README
@@ -0,0 +1,30 @@
+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 ext2 root file system
+build it all
+
+In your bin directory you will find a kernel and an ext2 root file system
+when it's finished. Just run it like this:-
+
+bin/openwrt-uml-2.6-vmlinux ubd0=bin/openwrt-uml-2.6-ext2.img
+
+The uml will start, and bring up an xterm with the serial console in it. 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
+
+http://user-mode-linux.sourceforge.net/