+========== Introduction ==========
+
+Basic approach:
+ 1. Get yourself a working Xen dom0 setup, eg according to
+ https://wiki.ubuntu.com/XenOnEdgy
+ 2. Configure adtxenlvm:
+ - assign a fixed IP address for the host and the testbed
+ - create DNS entries (forward and reverse)
+ for the testbed hostname edgy.adt.<your.domain.here>
+ - read below about settings you might want to set
+ creating /etc/autopkgtest/xenlvm_adt_config if needed
+ 3. adt-xenlvm-setup
+ 4. adt-xenlvm-with-testbed
+ 5. adt-xenlvm-on-testbed
+
+In some more detail, there are four main programs provided:
+
+ adt-xenlvm-setup [<config settings>]
+ Creates the snapshot. Broadly speaking, does the following:
+ - deletes any existing snapshot, virtual machine, etc.
+ - creates a new lvm volume and filesystem for the snapshot base
+ - runs debootstrap to install a system into the new filesystem
+ - makes necessary config changes to the testbed and the host
+ - boots the testbed and waits for it to start
+ - freezes the testbed into a snapshot file
+ After this, you can run with-testbed.
+
+ adt-xenlvm-with-testbed [<config settings>] [<master> [<args...>]]
+ Starts the testbed and runs <master> _on the HOST_. When
+ <master> finishes, the testbed state will be discarded. While
+ <master> is running, you can interact with the testbed. If
+ <master> is not specified, you get an interactive shell.
+
+ adt-xenlvm-on-testbed [<config settings>] [<command and args>]
+ Runs <command and args> on the running testbed. A <master>
+ child of adt-xenlvm-with-testbed must be running, or the
+ behaviour is not defined. However, adt-xenlvm-on-testbed does
+ not need to be a descendent of adt-xenlvm-with-testbed.
+ The arguments <command and args> are passed to ssh verbatim
+ and are therefore subject to ssh's unpleasant mangling.
+
+ adt-xenlvm-cleanup [<config settings>]
+ Cleans up any running testbed state. This is not normally
+ needed, as adt-xenlvm-with-testbed and adt-xenlvm-setup run it
+ at appropriate moments. However, if one of these should fail
+ and it is desirable to reclaim any resources used by the
+ testbed, cleanup will do this job.
+
+ adt-xenlvm-purge [<config settings>]
+ Deletes all of the data for the testbed. Ie, undoes
+ the effects of adt-xenlvm-setup.
+
+In each case [<config settings>] is zero or more arguments of the form
+ --<config-var>=<value>
+where <config-var> is one of the configuration items listed below.
+(On the command line, the configuration item name may be spelled with
+either hyphens or underscores.) Also, `--' may be used to indicate the
+end of the config vars.
+
+
+
+========== Configuration ==========