3 This project holds scripts that prepares a "rescue" boot image file
4 with a Devuan ceres minbase filesystem.
6 * +./minbase-strap.sh+ prepares boot-ceres-$ARCH.img
8 - +./minbase-strap-bios.sh+ include fragment preparing bios boot equipment
10 - +./minbase-strap-uefi.sh+ include fragment preparing uefi boot equipment
12 - +./minbase-strap-mkimg.sh+ include fragment packaging into disk file
14 * +./run.sh boot-ceres-$ARCH.img+ boots it up in a virtual machine.
16 == About the boot image preparation
18 The rescue boot image is a full disk image with two partitions. The
19 first is a FAT partition that contains a linux kernel and initrd for
20 the kernel and boot equipments using syslinux for both legacy bios and
23 The initrd.gz file is quite large makign the partition somewhat larger
24 than 100M and this makes it less ameniable as boot image for a hybrid
25 ISO (which has a 32M limit).
27 The preparation populates a root filesystem in the FS directory by
28 using debootstrap followed by certain "Captain's Picks" to include
29 partcular choice software.
31 The scripting asks firstly for a kernel choice and then an init script
32 choice to optionally replace the "standard" initrd init script with
35 == About the virtual machine setup
37 The run.sh script starts a QEMU system emulator for the boot image
38 given on the command line. E.g.,
40 $ ./run.sh boot-ceres-amd64.img
42 With environment setting EFI=yes, the emulation uses UEFI boot. E.g.
44 $ EFI=yes ./run.sh boot-ceres-amd64.img
46 The script assumes the host has a "vde2" setup with a "vde-switch"
47 using control directory "/run/vde.ctl". Any alternatie network setup
48 needs script hands-on to change the "NET=.." variable.