aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README32
1 files changed, 23 insertions, 9 deletions
diff --git a/README b/README
index 2c921c947e..45aab89f64 100644
--- a/README
+++ b/README
@@ -157,14 +157,29 @@ To fetch a local copy, install the BitKeeper tools, then run:
You can do a complete build of Xen, the control tools, and the
XenLinux kernel images with "make world". This can take 10 minutes
even on a fast machine. If you're on an SMP machine you may wish to
-give the '-j4' argument to make to get a parallel build. You should
-end up with all the binaries and images being placed in the ./install
-directory tree. You can then install everything to the standard
-system directories (e.g. /boot, /usr/bin, /usr/lib/python/ etc) by
-taping "make install".
-
-
-Inspect the Makefule if you want to see what goes on during a
+give the '-j4' argument to make to get a parallel build. All of the
+files that are built are placed under the ./install directory. You
+can then install everything to the standard system directories
+(e.g. /boot, /usr/bin, /usr/lib/python/ etc) by typing "make install".
+
+Take a look in install/boot/:
+ install/boot/xen.gz The Xen 'kernel' (formerly image.gz)
+ install/boot/vmlinuz-2.4.26-xen0 Domain 0 XenLinux kernel (xenolinux.gz)
+ install/boot/vmlinuz-2.4.26-xenU Unprivileged XenLinux kernel
+
+The difference between the two Linux kernels that are built is
+due to the configuration file used for each. The "U" suffixed
+unprivileged version doesn't contain any of the physical hardware
+device drivers, so is 30% smaller and hence may be preferred for
+your non-privileged domains.
+
+The install/boot directory will also contain the config files
+used for building the XenLinux kernels, and also versions of Xen
+and XenLinux kernels that contain debug symbols (xen-syms and
+vmlinux-syms-2.4.26-xen0) which are essential for interpreting crash
+dumps.
+
+Inspect the Makefile if you want to see what goes on during a
build. Building Xen and the tools is straightforward, but XenLinux is
more complicated. The makefile needs a 'pristine' linux kernel tree
which it will then add the Xen architecture files to. You can tell the
@@ -194,7 +209,6 @@ Using the domain control tools
Before starting domains you'll need to start the node management
daemon: "xend start".
-
The primary tool for starting and controlling domains is "xm".
"xm help <cmd>" will tell you how to use it.