From: Ralph Ronnquist <ralph.ronnquist@gmail.com>
Date: Fri, 4 Mar 2022 01:37:33 +0000 (+1100)
Subject: Revised pretend-boot description
X-Git-Url: https://git.rrq.au/?a=commitdiff_plain;h=refs%2Fheads%2Fmaster;p=rrq%2Fsubhost.git

Revised pretend-boot description
---

diff --git a/README.adoc b/README.adoc
index f041602..e1ebe93 100644
--- a/README.adoc
+++ b/README.adoc
@@ -10,26 +10,22 @@ than within virtual machines (VM).
 pretend-boot
 ------------
 
-The +pretend-boot+ script works together with the +subhost-init+
-script to run a subhost almost as if booted in a virtual machine,
-except of course, that it really is merely an "unshared sandboxing"
-executed by the the host kernel.
+The +pretend-boot+ script runs a subhost almost as if booted in a
+virtual machine, except of course, that it really is merely an
+"unshared sandboxing" executed by the the host kernel.
 
 .Example
 ----
 # ./pretend-boot mysubhost
 ----
 
-The named subhost must then be set up in the directory
-+/opt/sub/mysubhost+ with firstly a +config+ file and secondly a
-+live+ subdirectory that will be used as root filesystem mount point.
-
- 1. +config+ configuration that defines +DISKS+ and +BRIDGES+
- 2. +live+ empty directory for the root filesystem mount
-
-The +config+ file is a textfile, or in fact a +bash+ source file, that
-should set the variables +DISKS+ and +BRIDGES+ for the subhost.
-
++pretend-boot+ sets up the +/opt/sub/mysubhost/live+ directory that it
+uses as root filesystem mount point. It requires the variables DISKS
+and BRIDGES to be set, either as environment variables, or via a
+configuration file that it by default expects to find at
++/opt/sub/mysubhost/config+ That +config+ would be a textfile, or in
+fact a +bash+ source file, that should set the variables +DISKS+ and
++BRIDGES+ for running the subhost.
 
 ====
 **The +DISKS+ variable** is an array declaring the disks in terms the