# HG changeset patch # User Paul Boddie # Date 1334268802 -7200 # Node ID 57cd8352baae9de6e34da64a800010855f2da699 # Parent 536be9d977b52e663fca05313789c2d8e1dd86a7 Added more configuration-related details and some UML hints. diff -r 536be9d977b5 -r 57cd8352baae README.txt --- a/README.txt Mon Apr 02 22:59:52 2012 +0200 +++ b/README.txt Fri Apr 13 00:13:22 2012 +0200 @@ -54,6 +54,11 @@ debootstrap Tested with 0.3.3.2ubuntu3 on Ubuntu Hoary 5.04, 1.0.7~feisty1 on Ubuntu Feisty 7.04, 1.0.20~hardy1 on Ubuntu Hardy +New in userinstall 0.2.1 (Changes since userinstall 0.2) +-------------------------------------------------------- + + * Added more User Mode Linux documentation. + New in userinstall 0.2 (Changes since userinstall 0.1) ------------------------------------------------------ @@ -104,7 +109,9 @@ If a completely new userinstall-defaults file is created, it is essential that the above variables be defined so that the scripts know where to create or to -find the personal package manager. +find the personal package manager. Typically, a new userinstall-defaults file +will reside in the current directory when the different userinstall commands +are being issued. Creating a Personal Package Manager ----------------------------------- @@ -271,13 +278,22 @@ corresponding artsdsp program available to applications within the package manager. -Constructing UML Instances --------------------------- +Configuration of User Mode Linux Instances +------------------------------------------ For some applications, it can be desirable to provide a completely isolated environment for package installation and testing. This can be performed using the User Mode Linux (UML) software. +Alongside the userinstall-defaults file, a userinstall-defaults-uml file must +be made available. As with the generic userinstall-defaults file, the +UML-specific configuration in userinstall-defaults-uml must be edited to +reflect the desired settings such that appropriate network addresses are used +along with a suitable Linux kernel. + +Constructing UML Instances +-------------------------- + Since UML needs to see its filesystems as images, not directories within an existing filesystem, the uml-make-image script needs to create these image files. For example, to create a root filesystem 4GB in size, along with a swap @@ -351,6 +367,32 @@ instance, not merely as partitions, and so installers may ask you if you would like to partition these devices still further. +Once an installation has been performed using installation media, it should be +possible to omit the --initrd options when + +Using Graphical Desktop Environments with UML +--------------------------------------------- + +It is possible to start a graphical desktop environment from within a User +Mode Linux instance and display the desktop on the host's display. In the host +environment, access to the display must be granted using a program such as +xhost. For example, for a UML instance whose network address is 192.168.0.98: + +xhost +192.168.0.98 + +In the UML instance, the Xephyr program can be run to provide a display for +the graphical environment. For example, for a host that appears as +192.168.0.254 to the UML instance: + +DISPLAY=192.168.0.254:0.0 Xephyr :1 -screen 1024x768 & + +It should then be possible to start a desktop environment with the +Xephyr-based display specified as the appropriate display to use: + +DISPLAY=:1 gnome-session & + +Here, Xephyr has been started as screen :1. + Issues with Shared Memory ------------------------- diff -r 536be9d977b5 -r 57cd8352baae TO_DO.txt --- a/TO_DO.txt Mon Apr 02 22:59:52 2012 +0200 +++ b/TO_DO.txt Fri Apr 13 00:13:22 2012 +0200 @@ -1,3 +1,5 @@ +Overhaul the packaging for Debian. + See: http://www.gnewsense.org/Documentation/DebootstrappingGNewSense3 Support "full" installations by installing kernels and configuring various